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FOREWORD 


开放 互联 基金 会 (OCF) 是 物 联网 行业 最 大 的 组 织 之 一 ,其 任务 是 开发 标准 规范 ,促进 互 操作 性 ,并 
为 物 联网 (IoT) 设 备 提供 测试 认证 。OCF 联盟 拥有 超过 400 家 会 员 公 司 , 包 括 家 电 行 业 领导 者 (海尔 、 
LGE 、 伊 莱克 斯 .三 星 电子 ) ,芯片 制造 商 (英特尔 高通) ,软件 平台 (微软 ) ,网 络 设备 (Cisco) 和 有 线 服 务 
(CableLabs) 等 。OCF 联盟 还 发 起 一 个 开源 项 目 一 一 IoTivity, 帮 助 开发 者 和 企业 创建 解决 方案 ,实现 
一 个 开放 的 物 联网 规范 。 

OCF 2. 0 版 本 规范 已 经 发 布 , 业 内 人 士 预计 .OCF 2. 0 版 本 产品 认证 将 在 2018 年 第 四 季度 展开 ,并 
在 2019 年 继续 扩大 范围 。 随 着 越 来 越 多 的 OCF 产品 在 市 场 上 部 署 , 开 发 商 与 学 术 界 对 技术 理解 与 实 
现 具 有 强烈 的 需求 ,本 书 将 有 助 于 更 好 地 理解 OCF 技术 实现 。 

向 李 永 华 副教授 表示 衷心 的 感谢 ,他 抽出 个 人 的 时 间 完 成 这 本 有 价值 的 书 。 毫 无 疑问 ,会 有 很 多 人 
阅读 这 本 书 , 以 便 更 好 地 开发 物 联网 的 产品 和 服务 。 

John J. Park 
开放 互联 基金 会 首席 执行 官 


The Open Connectivity Foundation (OCF) is one of the largest groups in the industry whose 
mission is to develop specification standards, promote interoperability, and provide a certification 
program for devices involved in the Internet of Things (loT). It has over 400 member companies. 
including industry leaders in home appliances (Haier. LGE, Electrolux. Samsung Electronics). chip 
manufacturers (Intel, Qualcomm), software platforms (Microsoft), network equipment (Cisco), and 
cable services (CableLabs). OCF also sponsors an open source project. "IoTivity". to help developers 
and companies create solutions that map a single. open IoT specification. 

As OCF 2. 0 Specification is now published. the industry expects that OCF 2. 0 certified products 
will be launched in the fourth quarter of 2018 and continue to expand in 2019. As more OCF products 
are deployed in the market. there will be strong demand among developers and academia to understand 
OCF technology for implementation and research. This book will shed light upon OCF technology for 
those who hope to understand it better. 

I would like to express my sincere gratitude to associate professor Youghua Li. who took his 
personal time to write this valuable book. I have no doubt that this book will be read by many and 


provide insight on how to develop better IoT products and services. 


John J. Park 


Open Connectivity Foundation Executive Director 
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PREFACE 


近年 来 物 联网 快速 发 展 ,各 种 标准 、 技 术 层 出 不 穷 , 物 联网 的 应 用 领域 不 断 拓展 ,国际 数据 公司 预 
测 , 到 2020 年 ,全 世界 联网 装置 将 超过 2120 亿 个 ,市 值 将 达到 万 亿美 元 。 技 术 多 样 化 发 展 的 同时 ,也 为 
物 联 网 互联 互通 带 来 隐患 ,业界 制定 统一 标准 的 呼声 也 越 来 越 高 。2016 年 10 月 , OCF (Open 
Connectivity Foundation ,开放 互联 基金 会 ) 成 立 ,探索 建立 物 联网 统一 标准 ,真正 开发 一 套 通 用 的 物 联 
网 互联 架构 ,为 物 联 网 未 来 的 发 展 提供 了 新 的 思路 。 

OCF 由 Linux 基金 会 负责 运营 ,目前 包括 各 种 各 样 的 会 员 ,涉及 芯片 模块. 产品. 安全、 家 电 、 系 
统 、 集 成 等 多 方面 的 物 联网 厂商 ,这 种 跨 领 域 组 成 的 OCF, 有 助 于 开发 一 套 通用 的 物 联 网 互联 架构 ,为 
未 来 物 联 网 更 加 广泛 的 应 用 提供 了 技术 保障 。 

OCF 最 初 的 框架 来 源 OIC 和 Allloyn 开源 项 目 ,采用 Apache 和 BSD 许可 协议 。 无 论 是 终端 产 
品 、 应 用 、 服 务 , 通 过 OCF 技术 就 可 以 互相 通信 。OCF 是 由 开放 、 统 一 的 框架 和 核心 资源 组 成 ,让 开发 
者 通过 其 软件 开发 框架 开发 各 种 应 用 ,以 便 使 邻近 的 系统 ,应 用 或 设备 得 以 互联 互通 .控制 及 共享 资源 。 
OCF 最 终 希 望 打造 一 个 跨 平 台 . 接 人 方式、 编程 语言 的 开放 软件 架构 ,可 以 让 不 同 的 设备 (例如 电视 .路 
由 器 .冰箱 洗衣机、 智能 照明 系统 ) 和 其 他 设备 无 颖 地 连接 起 来 ,并 跨越 IOS, Android, Windows, Linux 
或 Mac 等 不 同 的 操作 系统 。 

本 书 以 当前 物 联网 的 发 展 为 背景 ,总 结 OCF 技术 的 原理 及 应 用 方法 。 从 物 联网 技术 开发 方法 出 
发 ,系统 地 介绍 如 何 利 用 OCF 技术 进行 不 同系 统 下 的 产品 研发 ,继而 进行 相应 的 应 用 。 因 此 ,本 书面 向 
未 来 的 物 联网 工业 创新 与 发 展 , 通 过 OCF 软件 架构 . 紧 紧 跟 随 技术 的 发 展 .为 物 联网 技术 的 发 展 提供 创 
新 型 人 才 。 同 时 ,本 书 总 结 了 实际 科研 中 的 应 用 技术 ,不 仅 包括 处 理 能 力 较 强 的 各 种 标准 客户 端 系统 应 
用 ,也 包括 能 力 相对 较 弱 的 瘦 客 户 端 系统 应 用 ,希望 对 教育 教学 及 工业 界 有 所 帮助 ,起 到 抛砖引玉 的 
作用 。 

本 书 的 主要 内 容 包 括 如 下 几 个 方面 : 物 联网 的 发 展 概述 .主要 介绍 物 联 网 的 产生 ,架构 ,技术 及 发 
展 情况 ; OCF 技术 的 基本 原理 , 曾 述 OCF 技术 框架 及 核心 功能 ; OCF 资源 模型 ,主要 描述 OCF 的 资源 
定义 以 及 资源 的 操作 、 功 能 交互 和 消息 传递 方法 ; OCF 的 具体 开发 方法 ,包括 基于 Mac, Windows, 
Linux, Android 和 Arduino 开发 的 方法 ,主要 描述 软件 工具 、 编 译 方法 ,实例 代码 和 综合 实例 。 

本 书 的 内 容 和 素材 主要 来 自 OCF 的 官方 网 站 (www. openconnectivity. org)。 首 先 , 本 书 是 作者 近 
几 年 承担 的 科研 成 果 和 教育 成 果 的 总 结 , 在 此 特别 感谢 林家 儒教 授 的 易 力 支持 和 悉心 指导 ; 其 次 ,本 书 
是 作者 指导 的 研究 生 在 物 联网 和 智能 硬件 方面 的 研究 工作 及 成 果 的 总 结 .在 此 特别 感谢 万 吴 、 谭 扬 、 黄 
旭 新 、 陈 佳 丰 、 王 表 等 同学 的 大 力 协助 ; 再 次 ,OCF 联盟 为 本 书 提供 了 第 一 手 资料 ,在 此 向 联盟 的 易 力 支 
持 表示 感谢 ; 最 后 .父母 妻 儿 在 精神 上 给 予 我 极 大 的 支持 与 鼓励 . 才 使 得 此 书 得 以 问世 ,向 他 们 表示 
感谢 ! 

本 书 由 北京 市 教育 科学 “十 二 五 ”规划 重点 课题 (优先 关注 ) .北京 市 职业 教育 产 教 融合 专业 建设 模 
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式 研究 (ADA15159) 资 助 ; 同时 ,本 书 也 由 北京 邮电 大 学 教育 教学 改革 项 目 (2017JY04) 资 助 ,在 此 一 并 
表示 感谢 ! 

本 书 内 容 由 浅 入 深 , 先 系统 后 实践 .技术 讲解 与 实践 案例 相 结 合 , 以 满足 不 同 层次 人 员 的 需求 ; 同 
时 ,本 书 附 有 实际 开发 的 软件 实现 代码 , 供 读 者 自我 学 习 和 自我 提高 使 用 。 本 书 可 作为 大 学 信息 与 通信 
工程 及 相关 领域 的 高 年 级 本 科 生 及 研究 生 的 教材 ,也 可 以 作为 物 联网 .OCF 技术 开发 人 员 的 技术 参考 
书 , 还 可 以 为 物 联网 方向 的 创 客 提供 帮助 。 

本 书 主要 由 李 永 华 编著 。 此 外 , 李 昕 烨 、 陈 河 泉 、 李 和 禹 、 陈 向 梅 , 张 秋 彤 、 张 国 利 也 参与 了 部 分 内 容 
的 编写 。 

由 于 作者 的 水 平 有 限 , 书 中 难免 存在 朴 漏 之 处 ,衷心 地 希望 各 位 读者 多 提 宝 贵 意见 及 具体 的 整改 措 
施 ,以 便 作 者 进一步 修改 和 完善 。 





李 永 华 于 北京 邮电 大 学 
2018 4F 4 H 
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CHAPTER 1 








互联 网 从 产生 到 现在 ,不 断 地 发 展 和 变化 。 在 互联 网 之 上 ,创造 了 许多 新 的 业务 应 用 和 商业 模式 。 
互联 网 不 断 变化 的 同时 ,各 种 技术 的 发 展 也 在 改变 着 IT 行业 的 发 展 方向 。 当 前 ,有 线 和 无 线 的 宽带 接 
和 无 处 不 在 ,而 且 价格 不 断 地 下 降 ; 智能 硬件 设备 可 以 搭载 多 种 传感器 , 变 得 更 加 强大 ,向 微型 化 发 展 ; 
多 种 设备 之 间 的 通信 互联 ,导致 互联 网 的 进一步 发 展 ,这 就 是 物 联网 。 当 接 入 设备 能 够 获取 更 多 网 络 数 
据 时 ,物理 实体 通过 相关 数据 ,可 以 为 网 络 用 户 提供 更 多 智能 服务 ,成 为 物 联网 发 展 的 主要 驱动 力量 。 

物 联网 描述 了 一 个 所 有 物体 全 部 成 为 互联 网 中 的 元 素 , 所 有 物体 都 拥有 独 有 的 特征 ,并 且 通 过 互联 
网 访问 可 以 获取 它 的 位 置 与 状态 .可 以 添加 各 种 服务 进行 智能 扩展 ,融合 了 数字 与 物理 世界 , 极 大 地 影 
响 着 个 人 和 社会 环境 。 因 此 ,通过 物 联 网 ,世间 万 物 正 朝 着 “永远 在 线 ” 的 方向 发 展 ,例如 ,绿色 IT、 能 源 
效率 ,智能 家 居 、\ 车 联网 、 可 穿戴 设备 ,智能 医疗 等 各 种 领域 ,不 胜 枚 举 。 物 联网 的 发 展 同时 伴随 着 挑战 : 
一 方面 ,不 同 技术 之 间 如 何 打破 壁垒 ,真正 实现 万 物 互联 ,包括 不 同 接 和 人 技术 之 间 、 不 同 操作 系统 之 间 、 
不 同 编程 语言 之 间 的 互联 互通 ; 另 一 方面 ,在 信息 安全 方面 ,为 确保 向 社会 各 领域 提供 一 个 公平 而 且 可 
信任 .开放 的 物 联网 ,标准 化 和 监管 是 必 不 可 少 的 。 

物 联网 的 发 展 在 国际 上 引起 了 高 度 的 重视 。 例 如 ,美国 提出 智慧 地 球 ; 中 国政 府 提出 感知 中 国 ; 欧 
盟 提交 《 物 联 网 一 一 欧洲 行动 计划 》 公 告 ,通过 构建 新 型 物 联网 管理 框架 来 引领 世界 物 联网 的 发 展 , 这 些 
都 是 对 未 来 物 联网 发 展 的 战略 性 构想 。 在 企业 层面 的 发 展 也 是 如 火 如 森 ,例如 ,苹果 公司 发 布 新 一 代 操 
作 系 统 , 实 现 更 流畅 的 苹果 设备 无 颖 对 接 . 个 人 健康 信息 管理 应 用 、 智 能 家 居 应 用 等 。 谷 歌 公 司 2014 年 
并 购 的 物 联网 公司 包括 Nest Labs( 智 能 恒温 器 制造 商 )、MyEnergy( 在 线 家 庭 水 、 电 、 天 然 气 使 用 管理 方 
案 提 供 商 ) .DropCam( 家 居 安 防 摄 像 头 制造 商 ) .Revolv( 智 能 家 居 自 动 化 控制 中 枢 制 造 商 ) 等 。Intel 公 
司 通过 高 性 能 .连接 性 、 安 全 性 为 物 联 网 实现 了 更 加 智能 的 嵌入 式 解 决 方案 。Microsoft 公司 为 企业 提 
供 一 种 独特 的 集成 方法 ,使 其 能 够 通过 收集 、 存 储 和 处 理 数据 来 利用 物 联网 的 优势 。 该 方法 通过 将 各 种 
产品 组 合 进行 扩展 ,包括 一 系列 个 人 计算 机 ,平板 电脑 企业 网 络 边缘 的 行业 设备 、 开 发 工具 、 后 台 系 统 
服务 以 及 多 样 化 的 合作 伙伴 生态 系统 。 

国内 的 企业 中 ,海尔 公司 提出 了 U 十 平台 (由 智能 数字 家 电 产 业 技术 创新 战略 联盟 推出 ), 这 是 一 个 
成 熟 的 商业 生态 系统 ,具有 行业 性 质 的 开放 平台 ,芯片 、 模 组 . 电 控 厂商 .开发 者 .投资 者 .电子 商务 . 云 服 
务 平 台 和 跨 平 台 合作 等 所 有 的 参与 者 都 能 从 中 受益 。 百 度 公司 的 语音 技术 通过 免费 .开放 的 策略 ,打造 
周边 信息 查询 .导航 .公交 线路 、 到 站 提醒 、 盲 人 路 线 自 定义 ,以 及 丰富 的 旅游 .餐饮 .购物 等 生活 服务 语 
音 模 块 ,并 进入 智能 手机 、 车 载 .教育 等 多 个 服务 领域 。 阿 里 巴巴 与 多 个 家 电厂 商 签署 战略 合作 协议 ,将 
共同 构建 基于 阿里 云 的 物 联网 开放 平台 ,实现 家 电 产 品 的 连接 对 话 和 远程 控制 ,在 未 来 形成 统一 的 物 联 
网 产品 应 用 和 通信 标准 ,实现 系列 家 电 产 品 的 无 缝 接 入 和 统一 控制 。 腾 讯 公司 从 手机 QQ、QQ 空间 等 
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移动 社交 平台 转移 到 以 应 用 宝 为 核心 的 分 发 渠道 , 随 着 开放 平台 及 智能 硬件 的 发 展 .开放 连接 的 另 一 端 
开始 指向 硬件 领域 ,腾讯 社交 智能 硬件 开放 平台 ,QQ 物 联 正式 切入 物 联网 领域 。 

总 体 而 言 , 目 前 世界 上 的 物 联 网 发 展 呈 现 了 多 元 的 趋势 ,大 型 的 科技 企业 准备 制定 自己 的 物 联 网 标 
准 , 也 有 一 些 企 业 联 合 起 来 成 立 了 联盟 ,制定 共同 的 物 联网 标准 。 在 全 球 物 联网 加 速 发 展 并 推动 产业 变 
革 之 际 ,企业 进一步 升级 设备 应 用 ,逐渐 向 智能 生活 移动 终端 过 渡 , 以 争夺 物 联 网 领域 的 主导 权 , 多 个 国 
际 物 联网 联盟 高 度 重视 物 联网 领域 并 展开 实际 的 研发 。 因 此 .未 来 一 定 会 出 现实 用 化 ,智能 化 的 物 联网 
标准 ,这 对 于 未 来 社会 的 发 展 必 将 产生 深远 的 影响 。 


1.1 物 联网 基本 架构 


物 联网 (Internet of Things,IoT) 是 通过 互联 网 ,传统 电信 网 等 信息 载体 ,让 所 有 独立 寻 址 的 普通 物 
理 对 象 实现 互联 互通 的 网 络 。 物 联网 一 般 为 无 线 网 ,由 于 每 个 人 周围 的 设备 可 以 达到 数 千 个 ,所 以 物 联 
网 将 包含 数 万 亿 个 物体 。 在 物 联网 上 ,每 个 人 都 可 以 应 用 智能 感知 将 真实 的 物体 联网 ,查找 出 它们 的 具 
体位 置 。 通 过 物 联 网 可 以 用 中 心计 算 机 对 机 器 、 设 备 、 人 员 进 行 集中 管理 ,控制 ,也 可 以 实现 对 设备 控 
制 . 位 置 搜寻 、 物 品 防盗 以 及 智能 推荐 等 的 各 种 应 用 。 物 联网 将 现实 世界 数字 化 ,应 用 范围 十 分 广泛 , 具 
有 十 分 广阔 的 市 场 和 应 用 前 景 。 根 据 国际 上 一 般 的 分 类 方法 , 物 联网 的 应 用 领域 主要 包括 运输 和 物流 
领域 ,健康 医疗 领域 .智能 环境 领域 .个 人 和 社会 领域 等 。 


1.1.1 物 联网 的 由 来 


互联 网 是 一 个 不 断 发 展 进化 的 实体 ,在 人 类 社会 的 发 展 中 越 来 越 重 要 ,通过 扩展 不 断 创造 新 的 价 
值 。 互联 网 开始 于 “计算 机 的 互联 网 ”, 是 世界 级 的 网 络 服务 ,万 维 网 则 建立 了 初始 的 顶层 平台 。 而 近 几 
年 ,互联 网 却 开 始 向 * 人 的 互联 网 ”方向 转变 ,创造 了 如 Web 2.0 的 概念 并 使 用 其 内 容 。 

技术 的 发 展 扩展 了 互联 网 的 边界 ,宽带 网 络 连 接 变 得 更 加 普及 ,无 论 是 在 发 达 国家 ,还 是 在 发 展 中 
国家 ,带宽 变 得 更 加 廉价 。 例 如 ,非洲 某 些 地 区 ,由 于 光纤 网 络 的 发 展 带 来 了 社会 各 个 方面 的 显著 进步 。 
一 方面 ,设备 硬件 的 处 理 能 力 与 存储 空间 正在 飞速 增长 .技术 发 展 让 这 些 设备 变 得 越 来 越 小 ; 设备 的 变 
化 不 仅 让 人 们 可 以 更 好 地 使 用 互联 网 ,而 且 创 造 了 一 系列 新 的 发 展 机 会 。 整 个 人 类 社会 正在 经 历 一 场 
以 个 人 计算 机 领域 为 主 到 以 移动 电子 设备 为 主 的 巨变 .包括 智能 手机 、 笔 记 本 电脑 及 平板 电脑 。 另 一 方 
面 ,这 些 设 备 由 于 传感器 和 探测 器 的 发 展 ,而 使 其 性 能 大 幅度 提升 ; 多 个 方面 的 结合 创造 了 一 个 任何 位 
置 的 设备 均 可 以 连接 至 网 络 中 的 环境 ,也 就 有 了 设备 感知 及 计算 ,通过 信息 传输 ,传感器 成 为 互联 网 的 
一 部 分 。 除 此 以 外 ,物理 设备 也 可 以 搭载 智能 硬件 而 被 其 他 设备 感知 .把 物理 世界 与 虚拟 世界 通过 智能 
设备 联系 到 一 起 ,把 互联 网 扩展 成 物 联网 。 

物 联网 的 实践 最 早 可 以 追溯 到 1990 年 施乐 公司 的 网 络 可 乐 贩 售 机 。1991 年 ,美国 麻 省 理工 学 院 
的 Kevin Ashton 教授 首次 提出 物 联网 的 概念 。1995 年 ,比尔 。 盖 茨 在 (未 来 之 路 》 一 书 中 也 曾 提 及 物 
联网 ,但 未 引起 广泛 重视 。1999 年 ,美国 麻 省 理工 学 院 建立 了 自动 识别 中 心 , 提 出 “万 物 皆 可 通过 网 络 
互联 ,阐明 了 物 联网 的 基本 含义 。 

随 着 技术 和 应 用 的 发 展 , 物 联网 的 内 涵 已 经 发 生 了 较 大 变化 。2003 年 ,美国 (技术 评论 ) 提 出 传 感 
网 络 技术 将 是 未 来 改变 人 们 生活 的 十 大 技术 之 首 。2005 年 11 月 17 日 ,在 突尼斯 举行 的 信息 社会 世界 
峰会 上 ,国际 电信 联盟 (ITU) 发 布 (ITU 互联 网 报告 2005: 物 联 网 ), 引 用 了 “ 物 联 网 ”的 概念 。 物 联网 的 
定义 和 范围 已 经 发 生 了 变化 , 覆盖 范围 有 了 较 大 拓展 ,不 再 只 是 基于 RFID (Radio Frequency 
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Identification, 射 频 识别 )。 为 了 促进 科技 发 展 ,寻找 新 的 经 济 增长 点 ,各 国政 府 开始 重视 下 一 代 的 技术 
规划 ,将 目光 放 在 了 物 联 网 上 。2008 年 11 H ,在 中 国 北京 大 学 举行 的 第 二 届 中 国 移动 政务 研讨 会 上 ， 
提出 “知识 社会 与 创新 2. 0"。 移 动 技术 、 物 联网 技术 的 发 展 代表 着 新 一 代 信息 技术 的 形成 ,并 带动 经 济 
社会 形态 .创新 形态 的 变革 ,推动 面向 知识 社会 ,以 用 户 体验 为 核心 的 创新 形态 的 形成 。 创 新 与 发 展 更 
加 关注 用 户 ,注重 以 人 为 本 ,而 创新 2. 0 的 形成 .又 进一步 推动 了 新 一 代 信息 技术 的 健康 发 展 。 


1.1.2 物 联网 的 结构 


在 物 联网 概念 中 ,“ 物 ”的 定义 是 非常 广 的 ,包含 各 种 不 同 的 物理 元 素 , 其 中 有 人 们 每 天 使 用 的 个 人 
产品 ,如 智能 手机 ,平板 电脑 和 数码 相机 等 ; 也 包括 环境 中 的 元 素 . 使 其 可 以 通过 网 关 与 人 们 相连 接 。 
基于 以 上 观点 的 “ 物 ”, 将 有 数量 庞大 的 设备 与 物体 接 入 到 互联 网 中 ,每 一 个 点 都 提供 了 数据 与 信息 ,其 
至 服务 。 物 联网 思维 让 连接 从 原来 的 “任何 时 间 、 任 何 地 点 、 任 何人 ” 变 成 了 “任何 时 间 、 任 何 地 点 、 任 何 
物 ”"。 这 些 事物 加 入 网 络 , 使 得 通过 智能 处 理 和 服务 支持 经 济 发 展 、 环 境 保护 和 人 类 健康 成 为 可 能 。 物 
联网 的 各 个 元 素 的 示意 图 如 图 1-1 所 示 。 
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图 1-1 物 联网 的 各 个 元 素 的 示意 图 


图 1-1 是 抽象 意义 上 的 物 联网 生态 系统 示意 图 ,其 中 设备 本 身 需 要 能 够 被 相应 的 技术 识别 。 通 过 
多 种 手段 辨识 出 设备 的 属性 当然 也 包括 相关 位 置信 息 。 相 应 地 .这 些 使 用 传感器 的 联网 物体 开始 变 得 
小 型 化 ,并 且 融 入 人 们 的 日 常生 活 , 传 感 器 和 执行 器 通过 网 络 环境 可 以 做 出 相关 反应 ,并 且 可 以 根据 具 
体 状况 和 时 间 做 出 更 高 级 的 服务 。 智 能 或 协作 物体 感知 到 相关 的 活动 与 状态 ,并 且 将 它们 连接 到 物 联 
网 中 。 中 间 件 和 框架 允许 其 他 设备 接收 所 需 的 数据 ,运行 相关 的 应 用 和 服务 .例如 ,云端 可 以 提供 容量 ， 
使 这 些 应 用 和 服务 的 质量 更 高 ,从 而 使 物 联网 按照 相关 的 设想 来 改变 环境 。 

从 这 个 意义 上 说 ,几乎 所 有 的 事物 都 能 连接 网 络 , 即 使 是 个 人 的 随身 物品 也 有 迹 可 循 , 它 的 状态 和 
位 置信 息 将 会 在 高 层次 的 服务 中 被 实时 获取 。 在 这 种 背景 下 .确定 物 联网 的 作用 范围 是 非常 重要 的 。 
几 十 亿 物 体 连 入 网 络 , 每 一 个 物体 都 提供 了 数据 .而 它们 中 的 大 部 分 都 能 影响 所 处 的 环境 。 当 处 理 这 些 
庞大 的 数据 时 ,需要 智能 设备 进行 判断 决策 。 因 此 ,可 以 利用 今天 已 经 熟知 的 互联 网 技术 ,逐渐 向 物 联 
网 方面 进化 ,以 这 种 形式 英 定 物 联网 的 基础 。 当 物 联网 领域 出 现 连续 的 技术 更 新 并 趋 近 成 熟 时 , 物 联 网 
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进化 的 核心 驱动 力 便 是 各 种 各 样 的 应 用 。 
随 着 物 联 网 的 发 展 , 人 们 提出 了 物 联网 的 技术 体系 框架 ,从 可 实现 的 角度 对 物 联 网 的 发 展 进 行 了 总 
结 ,如 图 1-2 所 示 。 








应 用 层 Fe 运营 平台 信息 中 心 内 容 服 务 专家 系统 
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图 1-2 物 联网 的 技术 体系 框架 示意 图 


感知 层 是 物 联网 感知 物理 世界 .获取 信息 和 实现 物体 控制 的 首要 环节 。 传 感 器 将 物理 世界 中 的 物 
理 量 ,化 学 量 .生物 量 转换 成 可 供 处 理 的 数字 信号 ,射频 识别 技术 实现 对 物 联网 中 物体 的 标识 和 信息 的 
获取 。 

传输 层 主要 实现 物 联网 数据 信息 和 控制 信息 的 双向 传递 .路 由 和 控制 。 重 点 包括 低速 近 距 离 无 线 
通信 技术 、 低 功 耗 路 由 、 自 组 织 通 信 、 无 线 接 入 技术 、M2M(Machine to Machine, 机 器 对 机 器 ) 通 信 增 强 、 
IP 承载 技术 、 网 络 传送 技术 、 异 构 网 络 融 合 接 入 技术 以 及 认 知 无 线 电 技术 等 。 例 如 ,移动 网 络 、 互 联网 、 
无 线 网 络 、 卫 星 和 Post-IP 网 络 等 。 

支撑 层 综合 运用 高 性 能 计算 、 人 工 智能 ,数据 库 和 模糊 计算 等 技术 .对 收集 的 感知 数据 进行 通用 处 
理 ,重点 涉及 数据 存储 、 并 行 计算 .数据 挖掘 ,平台 服务 .信息 呈现 等 。 例 如 ,智能 处 理 、 分 布 式 并 行 计 算 、 
云 计 算 技 术 ,海量 存储 与 数据 挖掘 ,管理 系统 及 数据 库 以 及 综合 设计 验证 等 。 

应 用 层 是 一 种 松 耦 合 的 软件 组 件 技术 。 它 将 应 用 程序 的 不 同 功 能 模块 化 .并 通过 标准 化 的 接口 和 
调用 方式 联系 起 来 ,实现 快速 可 重用 的 系统 开发 和 部 署 ; 可 提高 物 联网 框架 的 扩展 性 ,提升 应 用 开发 效 
率 ,充分 整合 和 复 用 信息 资源 。 例 如 ,运营 平台 信息 中 心 . 内 容 服 务 以 及 专家 系统 等 。 


1.2 物 联网 相关 技术 


当前 ,全 球 制造 业 的 发 展 越 来 越 呈 现 数字 化 、 网 络 化 和 智能 化 的 新 特征 。 

从 国家 层面 看 .美国 提出 “工业 互联 网 ”战略 ,德国 提出 “工业 4.0” 战 略 、 中 国 提出 “互联 网 十 ”战略 ， 
主要 意图 都 是 抢占 智能 制造 这 一 未 来 产业 竞争 的 制高点 。 

从 企业 层面 看 ,应 把 实施 互联 网 战略 作为 企业 提升 竞争 力 的 关键 环节 。 互 联网 不 再 只 是 企业 生产 
的 工具 和 手段 ,而 是 已 成 为 支撑 企业 成 长 的 关键 要 素 和 支撑 平台 。 基 于 互联 网 思维 下 的 企业 转型 升级 ， 
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推动 众多 新 业态 的 崛起 ,已 经 成 为 当前 制造 业 发 展 的 新 亮点 ,更 是 当前 经 济 形势 下 难得 的 发 展 机 遇 。 

从 技术 层面 看 , 物 联 网 是 互联 网 概念 的 延伸 。 如 果 说 互联 网 是 “ 软 ” 的 ,那么 物 联 网 则 是 “ 软 ( 云 平 
台 ) 十 硬 (智能 硬件 )” 的 模式 。 这 也 是 为 什么 互联 网 巨头 转型 到 物 联 网 时 ,需要 做 硬件 ,而 传统 的 硬件 公 
司 转型 到 物 联 网 就 要 做 云 平台 ,这 是 物 联 网 软 硬 件 的 互补 性 需求 。 物 联网 必须 * 软 硬结 合 , 硬 件 是 基础 
设施 ,连接 是 必要 条 件 。 通 过 硬件 获取 数据 及 软件 的 处 理 , 才 是 物 联网 的 核心 价值 。 因 此 , 物 联网 带 来 
的 价值 绝 大 多 数 将 来 自 云 平台 上 的 数据 。 也 就 是 说 ,未 来 物 联网 出 现 的 地 方 ,大 数据 \ 云 平台 就 像 挛 生 
兄弟 一 样 相伴 而 行 。 如 今 市 场 上 缺少 的 不 是 硬件 个 体 ,而 是 如 何 让 硬件 之 间 互 联 互 通 , 同 时 提供 多 样 的 
云 平台 服务 ,如 数据 的 存储 ,分 析 、 处 理 和 推送 ,这 样 才能 对 人 类 社会 的 进步 起 到 推动 作用 。 

物 联网 本 身 可 以 是 任意 大 小 的 网 络 。 例 如 , 物 联网 系统 可 以 是 一 种 智能 家 庭 局 域 网 ,为 了 方便 人 们 
在 室内 的 各 种 活动 而 形成 一 种 多 样 化 网 络 架 构 ,通常 由 灯光 照明 ,电器 控制 . 遗 阳 控制 ,节能 控制 .远程 
PR ,应 用 软件 .互联 规划 和 共享 网 络 等 子 系统 组 成 ,主要 利用 综合 布线 技术 、 网 络 通信 技术 .智能 家 居 
系统 设计 方案 、 安 全 防范 技术 、 自 动 控制 技术 和 音 视频 技术 将 与 家 居 生活 有 关 的 设施 集成 ,构建 高 效 的 
住宅 设施 与 家 庭 日 程 事务 的 管理 系统 ,提升 家 居 安 全 性 便利 性 ,舒适 性 和 艺术 性 ,并 实现 环保 节能 的 居 
住 环境 。 也 就 是 说 ,如 今 物 联网 发 展 所 取得 的 成 果 , 是 建立 在 技术 进步 基础 上 的 。 下 面 将 简单 介绍 物 联 
网 的 相关 技术 。 


1.2.1 BARA 


在 智能 家 居 领 域 ,有 线 组 网 技术 是 最 先 兴起 的 ,这 种 组 网 方式 具有 稳定 性 高 .通信 速度 快 等 优点 ,但 
存在 着 网 络 庞大 ,布线 复杂 .灵活 性 差 等 诸多 缺点 。 总 的 来 说 ,经 过 多 年 的 发 展 , 有 线 组 网 技术 普及 率 较 
高 ,市场 出现 了 许多 成 熟 的 技术 。 有 线 方 式 主 要 包括 电力 线 载 波 . 电 话 线 方式 `. 以 太 网 方式 的 IEEE 
802.3 以 及 专用 总 线 方式 的 IEEE 1394 等 。 物 联网 中 使 用 的 传统 布线 方案 ,不 仅 布线 复杂 且 成 本 高 昂 ， 
因此 ,基于 无 线 技术 的 物 联网 互联 方案 渐渐 获得 市 场 的 青睐 。 下 面 对 目 前 无 线 和 有 线 的 接 人 方式 做 简 
单 的 介绍 。 

1. ZigBee 技术 

ZigBee 技术 作为 一 种 低速 短 距离 传输 的 无 线 网 络 协 议 ,在 物 联网 领域 获得 了 广泛 的 使 用 ,替代 了 
传统 的 有 线 布线 。 基 于 ZigBee 的 智能 家 居 能 源 管理 系统 ,简化 了 家 庭 布线 的 复杂 度 , 实 现 了 家 电 的 无 
线 互联 ,为 用 户 提 供 了 舒适 的 家 庭 环 境 、 方 便 易 用 的 家 电 管 理 以 及 远程 查看 和 管理 家 电 的 功能 。ZigBee 
协议 以 低 功 耗 、 低 成 本 、 低 速率 、 低 复杂 度 和 易 组 网 等 特点 已 经 在 医疗 监护 、 环 境 监 测 .智能 交通 、 智 能 电 
网 和 智能 家 居 等 方面 得 到 了 广泛 研究 与 应 用 。 

为 了 方便 管理 家 电 的 工作 模式 ,使 用 基于 ZigBee 技术 的 智能 插座 和 红外 遥控 器 等 技术 实现 对 家 电 
的 无 线 控制 。 其 中 ,智能 插座 可 以 对 所 有 家 电 执 行 简单 的 开关 控制 ; 而 红外 遥控 器 则 可 以 对 空调 .电视 
机 等 多 控制 状态 的 家 电 执 行 控制 ,为 家 庭 用 户 提 供 了 方便 易 用 的 家 电 控 制 ,美中不足 是 无 法 满足 远 距离 
家 庭 用 户 管理 家 电 的 需求 。 针 对 这 个 问题 ,有 文章 提出 使 用 基于 Web 的 动态 网 页 远程 管理 家 电 的 智能 
家 居 系 统 , 使 用 嵌入 式 操作 系统 .以 ARM Cortex-M3 作为 系统 控制 器 ,使 用 ZigBee 无 线 传感器 网 络 实 
现 家 电 控 制 以 及 环境 信息 采集 ,提供 动态 网 页 供用 户 远 程 访问 家 电 环 境 信 息 以 及 控制 家 电 设 备 。 

2. 红外 通信 技术 

红外 通信 技术 是 以 红外 线 作 为 通信 介质 的 特定 应 用 ,通常 用 在 移动 电话 、 笔 记 本 电脑 和 掌上 电脑 
中 。 红 外 通信 和 是 被 设计 用 于 短 距离 , 低 功率 、 无 需 许 可 证 的 通信 。 但 是 红外 通信 由 于 技术 原因 ,导致 传 
输 距离 受到 很 大 限制 。 例 如 ,红外线 不 能 穿越 阻挡 信号 的 物体 、 传 输 角度 不 能 过 大 等 。 因 此 ,在 早期 的 
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智能 家 居 应 用 中 使 用 红外 技术 的 效果 并 不 理想 。 

在 智能 家 居 系 统 中 ,常常 利用 ZigBee 技术 来 控制 红外 遥控 器 ,从 而 间接 地 控制 基于 红外 通信 的 家 
用 电器 。 因 为 角度 的 偏离 会 影响 设备 对 红外 线 的 接收 ,可 将 红外 遥控 器 固定 在 室内 合适 的 位 置 ,这 样 人 
们 就 可 以 通过 ZigBee 技术 向 红外 遥控 器 发 送 指令 ,这些 指令 经 过 遥控 器 识别 后 转换 成 相应 的 红外 通信 
指令 ,并 发 送 到 相应 的 红外 控制 家 电 上 。 使 用 基于 ZigBee 技术 的 红外 遥控 器 ,可 以 免 去 对 家 电 的 更 新 ， 
只 对 遥控 器 进行 重新 设计 ,实施 起 来 较为 方便 ,但 是 这 样 仅仅 实现 了 对 红外 家 电 的 简单 控制 ,没有 任何 
家 电信 息 的 收集 与 交互 。 

3. 蓝牙 技术 

蓝牙 技术 是 无 线 数据 和 语音 传输 的 开放 式 标准 , 它 将 各 种 通信 设备 .计算 机 及 其 终端 设备 .各 种 数 
字数 据 系统 .家 用 电器 采用 无 线 方式 连接 起 来 。 该 技术 用 于 替代 便携 ,固定 电子 设备 上 所 使 用 的 电缆 连 
线 ,是 短 距 离 无 线 连接 技术 ,工作 在 2. AGHz 的 开放 频段 上 ,采用 1600 次 /s 的 扩 频 技术 ,发 射 功率 为 三 
Æ. E 1m W , 10m W 和 100mW, 通 信 距 离 为 10 一 100m., 传 输 速 率 约 为 3Mb/s。 在 传输 数据 信息 的 时 候 ， 
还 可 传输 一 路 话音 信息 ,这 也 是 蓝牙 技术 的 重要 特点 之 一 。 

蓝牙 技术 适用 于 在 短 距离 (大 约 10m) 范 围 内 蔡 代 电缆 ,如 果 增 大 发 射 功率 , 它 的 传输 距离 可 达 
100m, 而 家 庭 中 各 家 电 之 间 的 相隔 距离 一 般 不 会 超过 此 距离 。 蓝 牙 传 输 速率 完全 可 以 满足 家 庭 网 络 中 
各 家 电 间 的 数据 传输 ; 而 且 , 蓝 牙 的 抗 干扰 能 力 强 , 它 的 快速 跳 频 使 系统 更 加 稳定 ,前 向 纠 错 能 力 可 以 
限制 噪声 的 影响 ,这 样 家庭 中 的 各 种 蓝牙 家 电 可 以 互 不 干扰 而 正常 工作 ; 蓝牙 系统 具有 连接 的 普遍 性 、 
标准 的 开放 性 以 及 强大 的 扩展 性 ,可 以 满足 家 庭 网 络 中 的 多 种 需要 ; 蓝牙 芯片 的 成 本 相对 较 低 ,因而 可 
大 大 降低 网 络 家 电 的 成 本 ; 中 国 无 线 电 管理 委员 会 已 对 蓝牙 技术 开放 了 相应 的 频段 ,这 起 到 了 推广 的 
作用 。 

基于 蓝牙 技术 的 智能 家 居 控 制 方法 ,在 需要 控制 的 家 电 中 嵌入 蓝牙 模块 ,从 而 组 成 蓝牙 控制 网 络 。 
利用 能 入 式 模块 构成 智能 家 居 控 制 器 .个 人 计算 机 模拟 家 庭 主 网 关 、 单 片 机 加 蓝牙 模块 模拟 信息 家 电 ， 
把 三 者 结合 组 成 模拟 的 家 庭 控制 子 网 ,实现 家 庭 控制 子 网 对 家 电 设备 的 基本 操作 ; 采用 以 智能 家 居 控 
制 器 为 中 心 的 完全 星 形 组 网 方式 ,所 有 子 网 设备 直接 与 智能 家 居 控 制 器 进行 通信 以 完成 子 网 的 控制 和 
管理 功能 ,组 网 简单 .实现 即 插 即 用 。 

4. WiFi 

WiFi 是 一 种 可 以 将 个 人 计算 机 、 智 能 移动 设备 等 终端 以 无 线 方式 互相 连接 的 技术 ,可 以 方便 地 与 
现 有 的 有 线 以 太 网 络 整 合 ,组 网 成 本 低 , 通 常 对 应 以 个 人 计算 机 共享 上 网 为 主要 应 用 模式 的 家 庭 网 络 
服务 。 

在 嵌入 式 处 理 器 和 操作 系统 基础 上 .利用 WiFi 模块 互联 各 个 家 电 终 端 ,组 建 家 庭 无 线 网 络 。 系 统 
采用 典型 的 客户 机 与 服务 器 架构 .充分 发 挥 客户 端 个 人 计算 机 的 处 理 优势 .实现 在 WiFi 热点 区 域 接 入 
无 线 通信 终端 ,对 家 电 设备 远 程控 制 。 也 可 以 基于 ZigBee 网 络 与 WiFi 视频 监控 网 络 构 成 智能 家 居 监 
控 系 统 ,利用 ZigBee 传输 标量 数据 和 控制 信号 、WiFi 传输 音 视频 数据 ,并 为 下 层 的 ZigBee 网 络 提供 互 
联网 接 入 的 网 关 功 能 ,发 挥 两 种 无 线 技术 的 优势 。 

5. 蜂窝 移动 通信 网 

蜂窝 移动 通信 采用 蜂窝 无 线 组 网 方式 ,在 终端 和 网 络 设备 之 间 通 过 无 线 通道 连接 起 来 ,进而 实现 用 
户 在 活动 中 可 相互 通信 。 其 主要 特征 是 终端 的 移动 性 ,并 具有 越 区 切换 和 跨 本 地 网 自动 漫游 的 功能 。 
蜂窝 移动 通信 是 指 由 基站 子 系统 和 移动 交换 子 系统 等 设备 组 成 蜂窝 移动 通信 网 .并 提供 话音 、 数 据 、 视 
频 图 像 等 业务 。 移 动 通信 网 主要 包括 第 二 代 移 动 通信 系统 GSM、CDMA. 第 三 代 移 动 通信 系统 
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WCDMA .CDMA2000 以 及 TD-SCDMA ,第 四 代 移 动 通信 系统 ,第 五 代 移 动 通信 系统 ,等 等 。 

6. 电力 线 

网 络 信息 传输 介质 用 电力 线 有 很 大 优势 。 目 前 ,大 多 数 家 居中 已 经 铺设 电力 线 , 电 缆 不 需要 另外 布 
设 , 虽 然 这 样 降低 了 施工 难度 ,但 是 家 庭 中 所 使 用 的 手持 移动 设备 不 能 采用 电力 线 接 人 网 络 。 另 外 , 电 
力 线 的 缺点 是 传输 速率 较 慢 , 仅 有 300kb/s, 不 能 满足 数字 信号 音频 和 视频 信号 的 传输 ,保密 性 差 ,标准 
未 统一 , 接 和 人 设备 昂贵 等 。 目 前 ,国际 上 采用 电力 线 作为 联网 传输 介质 推出 的 解决 方案 有 X-10、 
CEBus 等 。 

7. 电话 线 

HomePNA(Home Phoneline Networking Alliance, 家 庭 电话 线 网 络 联盟 ) 是 一 个 非 营利 性 组 织 BO 
力 于 协调 采用 统一 的 标准 、 统 一 电话 线 网 络 的 工业 标准 。 该 联盟 在 1998 年 由 11 个 公司 共同 建立 , 旨 
以 家 庭 电话 线 为 连接 介质 构造 家 庭 网 络 .使 用 频 分 复 用 技术 ,在 同一 条 电话 线 上 同时 传送 话音 和 数据 信 
号 , 当 用 户 上 网 时 , 打 电 话 和 收发 传真 都 不 受 影响 。HomePNA 先后 推出 两 个 版 本 ,分 别 是 
HomePNA 1. 0 和 2.0, 其 中 1.0 版 本 支持 Mb/s 的 速率 ,2. 0 版 本 支持 10Mb/s UERR, MAZE 
公司 曾 推出 基于 此 项 技术 的 家 用 智能 产品 。 这 种 方式 是 通过 在 电话 线 上 加 载 高 频 载波 信号 来 实现 信息 
传递 的 ,可 以 同时 满足 电话 业务 .XDSL 和 家 庭 内 部 数据 传输 , 且 互 不 干扰 。 利 用 墙 上 预 留 的 电话 线 插 
座 , 能 够 避免 重新 布线 ,但 是 在 家 庭 中 电话 线 插座 不 可 能 随处 安装 ,在 扩充 新 节点 时 还 是 会 面临 重新 布 
线 的 问题 。 

8. 以 太 网 

以 太 网 指 的 是 由 Xerox 公司 创建 并 由 Xerox Intel 和 DEC 公司 联合 开发 的 基带 局 域 网 规范 。 该 技 
术 基 于 铜 介 质 的 双 绞 线 和 同 轴 电缆 实现 信号 的 双向 传输 ,数据 传输 率 很 高 ,可 以 达到 10Mb/s、100Mb/s 
和 1000Mb/s, 能 够 传输 数据 、 电 话 、 视 频 以 及 家 电 控 制 信息 ,主要 用 于 有 线 局 域 网 和 高 速 互联 网 。 现 阶 
段 , 以 太 网 技术 在 目前 的 家 庭 设备 互 连 中 是 最 简单 也 是 最 普及 的 ,成 本 低 , 但 专门 布线 费用 高 ,安装 维护 
比较 困难 ,几乎 不 具备 移动 性 .家庭 中 的 用 户 宁 可 使 用 已 经 铺设 好 的 电话 线 或 电缆 ,也 不 愿意 再 安装 以 
太 网 线 。 因 此 ,以 太 网 方式 可 能 是 家 庭 网 络 发 展 初期 的 解决 方案 ,但 不 是 家 庭 网 络 的 最 终 方案 。 

9. 专用 总 线 

通过 采用 专用 总 线 的 形式 来 实现 家 庭 控制 网 络 组 建 ,并 完成 小 区 的 智能 相连 ,如 RS-485 总 线 解决 
方案 。 它 的 优点 是 抗 干扰 能 力 比较 强 , 技 术 相 对 成 熟 ; 缺点 是 需要 重新 铺设 线路 ,给 用 户 带 来 麻烦 。 

10. RFID 技术 

RFID 技术 是 一 种 通信 技术 ,可 通过 无 线 电 信号 识别 特定 目标 并 读 写 相关 数据 ,而 无 须 在 识别 系统 
与 特定 目标 之 间 建 立 机 械 或 光学 接触 。 常 用 的 有 低频 、 高 频 、 超 高 频 和 微波 等 技术 。RFID 读 写 器 分 为 
移动 式 和 固定 式 , 目 前 RFID 技术 应 用 很 广 , 例 如 应 用 在 图 书馆 .门禁 系统 和 食品 安全 溯源 等 方面 。 

从 概念 上 来 讲 ,RFID 类 似 于 条 码 扫描 。 对 于 条 码 技术 而 言 , 它 是 将 已 编码 的 条 形 码 附着 于 目标 物 
并 使 用 专用 的 扫描 读 写 器 ,利用 光 信号 将 信息 传送 到 扫描 读 写 器 ; 而 RFID 则 使 用 专用 的 RFID 读 写 器 
及 专门 的 ,可 附着 于 目标 物 的 RFID 标签 ,利用 频率 信号 将 信息 由 RFID 标签 传送 至 RFID 读 写 器 。 从 
结构 上 来 讲 ,RFID 是 一 种 简单 的 无 线 系统 ,用 于 控制 .检测 和 跟踪 物体 。 该 系统 只 有 两 个 基本 器 件 , 由 
一 个 询问 器 和 很 多 应 答 器 组 成 。RFID 技术 的 飞速 发 展 对 于 物 联 网 领域 的 应 用 具有 重要 意义 。 

11. NFC 技术 

NFC(Near Field Communication, 近 场 通信 ) 技 术 是 一 种 短 距离 高 频 的 无 线 电 技术 ,在 13. 56MHz 
频率 运行 于 20cm 距离 内 。NFC 技术 由 RFID 技术 演变 而 来 .由 飞利浦 半导体 .诺基亚 和 索尼 公司 共同 
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研制 开发 ,其 基础 是 RFID 及 互联 技术 。 其 传输 速率 有 106kb/s,212kb/s 和 424kb/s 三 种 。 目 前 NFC 
TOR EUR ISO/IEC IS 18092 国际 标准 .ECMA-340 标准 与 ETSI TS 102 190 标准 。NFC 技术 采用 主 
动 和 被 动 两 种 读 取 模式 ; 在 单一 芯片 上 结合 感应 式 读 卡 器 .感应 式 卡片 和 点 对 点 的 功能 ,能 在 短 距 离 内 
与 兼容 设备 进行 识别 和 数据 交换 ,但 是 使 用 这 种 手机 支付 方案 的 用 户 必 须 更 换 特 制 的 手机 。 目 前 ,这 项 
技术 已 被 广泛 应 用 ,如 果 配 置 了 这 种 支付 功能 的 手机 ,就 可 以 行 遍 全 国 ,手机 可 以 用 作 机 场 登 机 验证 .大 
厦 的 门禁 钥匙 、 交 通 一 卡通 、 信 用 卡 和 支付 卡 等 。 


1.2.2 基于 网 络 的 信息 管理 技术 


无 线 通信 技术 提供 了 家 电 互 联 的 可 能 性 ,而 Web 技术 的 融入 将 会 使 家 电信 息 的 管理 变 得 更 加 方 
便 。 越 来 越 多 的 传感器 正在 接 人 互联 网 ,包括 便携 式 传感器 .如 手机 中 自 带 的 各 种 传感器 .环境 感应 传 
感 器 组 成 的 传感器 网 络 .智能 家 居中 的 传感器 .各 种 商品 货物 上 的 标识 传感器 ,它们 共同 组 成 了 物 联 网 。 

传感器 的 目的 是 监测 数据 ,形成 一 个 庞大 的 监测 网 络 ,供用 户 参 考 。 为 了 更 好 地 管理 传感器 网 络 和 
利用 传感器 网 络 所 监测 的 数据 ,Web 技术 脱颖而出 , 它 将 传感器 网 络 中 的 各 种 数据 资源 .监测 设备 .应 
用 系统 和 计算 资源 都 融合 在 互联 网 上 ,形成 了 另外 一 种 概念 上 的 物 联 网 , 即 物 联 Web。 它 能 够 让 人 们 
实时 全面, 智能, 可靠 地 监测 和 管理 现实 世界 的 对 象 ,用 户 能 够 方便 地 获得 感 兴趣 的 传感器 或 传感器 的 
观测 值 ,从 而 根据 这 些 观 测 值 来 决定 对 设备 的 下 一 步 动 作 。 

1. 家 电 传 感 器 检索 技术 

用 户 要 方便 地 获得 智能 家 居 传 感 器 或 传感器 对 家 电 的 观测 值 , 需 要 用 到 检索 技术 。 当 前 的 检索 方 
式 可 以 分 为 两 类 : 语义 检索 和 相似 性 检索 。 其 中 ,语义 检索 分 为 简易 文本 检索 和 详细 文本 检索 。 简 易 
文本 检索 支持 检索 描述 传感器 的 文本 元 数据 ,例如 传感器 的 类 型 ,位置 和 测量 单位 等 ,但 是 实际 应 用 性 
不 强 , 因 为 人 们 描述 同一 概念 的 方式 不 同 , 简 易 文 本 的 绑 定 容易 造成 检索 误差 ; 详细 文本 检索 将 描述 传 
感 器 多 个 相关 的 文本 元 数据 标记 在 传感器 上 ,提供 传感器 描述 表 及 详细 的 传感器 描述 ,这 在 一 定 程度 上 
降低 了 用 户 检索 的 误差 ,但 是 执行 复杂 .相关 的 文本 元 数据 确定 不 易 。 相 似 性 检索 技术 在 一 定 程度 上 降 
低 了 语义 检索 的 文本 输入 准确 度 要 求 , 以 图 片 或 者 数据 检索 与 其 相似 的 传感器 或 传感器 数据 ,提高 了 易 
用 性 。 检 索 技术 可 以 用 于 智能 家 居 的 客户 端 ,使 用 相似 性 检索 有 利于 客户 端 在 不 同 地 方 使 用 ,不 用 进行 
客户 端 与 智能 家 居 的 单独 匹配 ,适合 多 种 平台 。 

2. RAK Web 服务 器 

智能 家 居 控 制 器 是 一 个 由 软件 和 硬件 共同 组 成 的 .具有 计算 机 能 力 的 功能 实体 .实现 它 的 一 种 方法 
就 是 采用 个 人 计算 机 。 个 人 计算 机 不 仅 具有 足够 的 能 力 实现 控制 与 网 关 功 能 ,而 且 可 以 很 方便 地 实现 
控制 与 网 关 功能 ,但 是 作为 控制 中 心 也 有 它 的 不 足 . 如 体积 大 、 功 耗 大 和 成 本 高 ,所 以 使 用 个 人 计算 机 作 
为 智能 家 居 控 制 器 并 不 合适 。 为 了 克服 个 人 计算 机 的 这 些 不 足 . 可 以 采用 嵌入 式 系 统 来 实现 基于 以 太 
网 的 智能 家 居 控 制 器 。 嵌 入 式 系统 以 应 用 为 中 心 , 针 对 家 居 控 制 中 心 的 要 求 ,在 软 硬 件 上 可 定制 设计 ， 
使 之 在 功能 .可 靠 性 .成 本 体积 和 功 耗 等 方面 符合 家 庭 控制 中 心 的 要 求 。 

BEF RRA SK Web 服务 器 系统 的 网 络 智能 家 居 控 制 器 ,不 仅 符合 物 联网 的 发 展 趋势 ,而 且 具 有 很 好 
的 技术 研究 和 应 用 价值 ,其 中 一 些 用 于 控制 电灯 、 电 冰箱 、 空 调 等 家 用 电器 的 运行 状态 。 例 如 , 物 联 网 控 
制 器 采用 ARM 处 理 器 作为 核心 处 理 单元 ,硬件 平台 由 处 理 器 和 以 太 网 控制 器 等 组 成 ,软件 平台 主要 以 
精简 TCP/IP 协议 栈 为 核心 , 软 硬 件 共同 组 建 了 嵌入 式 物 联网 Web 服务 器 。 精 简 TCP/IP 协议 栈 包 括 
以 太 网 控制 器 驱动 程序 .ARP 协议 模块 .IP 协议 模块 ICMP 协议 模块 .TCP 协议 模块 和 HTTP 协议 模 
块 。 在 HTTP 协议 的 基础 上 ,建立 嵌入 式 Web 服务 器 TCP/IP 应 用 。 用 户 可 以 使 用 任意 浏览 器 对 家 
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居中 的 设备 和 环境 进行 检测 和 控制 。 

采用 ZigBee 技术 与 嵌入 式 Web 服务 器 相 结 合 的 方式 可 以 控制 物 联网 。 使 用 ZigBee 技术 可 以 组 建 
家 居 无 线 控制 网 络 ,并 且 实 现 所 有 节点 之 间 的 数据 收发 ,组 网 灵活 ,加 入 或 退出 节点 都 极为 方便 ; 加 入 
MAX Web 服务 器 ,不 仅 提供 了 用 户 通过 浏览 器 查询 家 居 温 度 、 控 制 家 居中 灯节 点 的 功能 ,还 可 以 设计 
一 个 较为 友好 的 访问 界面 。 

总 体 来 说 ,当今 主流 的 物 联网 无 线 接 入 技术 .可 以 很 好 地 实现 物 联网 之 间 的 互联 ,而 Web 技术 的 引 
入 , 极 大 地 方便 了 家 电信 息 的 查询 管理 。 对 于 物 联网 的 管理 ,除了 嵌入 式 Web 服务 器 以 外 ,还 有 基于 
Android 和 iOS 平 台 的 应 用 程序 ,通过 相应 的 软件 来 对 物 联网 进行 管理 。 这 些 物 联网 能 够 启动 的 前 提 
是 控制 端 与 各 个 接 入 家 庭 网 的 智能 家 电 . 在 系统 上 必须 保证 匹配 。 也 就 是 说 ,所 有 家 电 必 须要 有 统一 的 
标准 ,这 样 才能 使 控制 端 较 好 地 对 其 进行 操作 。 而 当今 物 联 网 的 控制 标准 尚 缺 ,平台 匹配 较 差 , 物 联网 
需要 定制 ,大 大 影响 了 用 户 对 家 电 的 选择 性 ,因此 出 台 相应 的 物 联 网 标准 和 适用 于 智能 家 电 系 统 的 平台 
极为 迫切 。 

3. 云 计算 技术 

云 计算 是 由 谷歌 公司 提出 的 一 种 网 络 应 用 模式 。 狭 义 云 计算 是 指 IT 基础 设施 的 交付 和 使 用 模式 ， 
指 通过 网 络 以 按 需 、 易 扩展 的 方式 获得 所 需 资源 ; 广义 云 计算 是 指 服务 的 交付 和 使 用 模式 , 指 通过 网 络 
以 按 需 、 易 扩展 的 方式 获得 所 需 服务 。 这 种 服务 可 以 是 和 IT、 软件 .互联 网 相关 的 服务 ,也 可 以 是 任意 
其 他 的 服务 ,具有 超大 规模 、 虚 拟 化 、 安 全 可 靠 等 独特 功能 。 

云 计算 是 把 一 些 相关 网 络 技术 和 计算 机 融合 在 一 起 的 产物 ,对 存储 系统 和 计算 机 进行 调整 ,将 分 布 
式 计 算 的 信息 和 数据 利用 互联 网 完成 信息 传输 ,使 资源 的 利用 效率 更 高 ,目的 是 把 各 种 任务 进行 低 成 本 
处 理 并 融合 为 功能 完整 的 实体 。 云 计算 是 以 加 强 改善 其 处 理 能 力 为 重点 ,用 户 终端 的 负担 相应 降低 ， 
1/O 设备 能 够 简化 ,还 可 以 对 它 的 计算 功能 进行 合理 的 分 配 应 用 。 例 如 ,百度 等 搜索 功能 就 是 它 的 应 用 
Z=, 

随 着 物 联网 产业 的 深入 发 展 , 物 联网 发 展 到 一 定 规模 后 ,物理 资源 与 云 计算 结合 水 到 渠 成 。 对 于 一 
部 分 物 联 网 行业 应 用 ,如 智能 电网 、 地 震 台 网 监测 等 ,终端 数量 的 规模 化 导致 物 联网 应 用 对 物理 资源 产 
生 了 大 规模 需求 ,一 个 是 接 入 终端 的 数量 可 能 是 海量 的 , 另 一 个 是 采集 的 数据 可 能 是 海量 的 。 云 计算 在 
物 联 网 中 的 应 用 主要 有 三 种 : IaaS(Infrastructure-as-a-Service, 基 础 设施 即 服务 ) 模 式 、SaaS(Software- 
as-a-Service, 软 件 即 服务 ) 模 式 和 PaaS(Platform-as-a-Service. 平 台 即 服务 ) 模 式 。 

CL) IaaS 模式 在 物 联网 中 的 应 用 。 无 论 是 横向 的 、 通 用 的 支撑 平台 ,还 是 纵向 的 ,特定 的 物 联网 应 
用 平台 ,都 可 以 在 laas 技术 虚拟 化 的 基础 上 实现 物理 资源 的 共享 ,实现 业务 处 理 能 力 的 动态 扩展 。 
TaaS 技术 在 对 主机 ,存储 和 网 络 资源 的 集成 与 抽象 的 基础 上 ,具有 可 扩展 性 和 统计 复 用 能 力 ,允许 用 户 
按 需 使 用 。 除 网 络 资源 外 ,其 他 资源 均 可 通过 虚拟 化 提供 成 熟 的 技术 实现 ,为 解决 物 联 网 应 用 的 海量 终 
端 接 入 和 数据 处 理 提供 了 有 效 途径 。 同 时 ,1aaS 对 各 类 内 部 异 构 的 物理 资源 环境 提供 了 统一 的 服务 界 
面 , 即 为 资源 定制 .出 让 和 高 效 利 用 提供 了 统一 界面 ,也 有 利于 实现 物 联网 应 用 的 软 系统 与 硬 系统 之 间 
某 种 程度 的 松 艳 合 关系 。 目 前 ,国内 建设 与 物 联网 相关 的 云 计算 中 心 、 云 计算 平台 ,主要 是 laas 模式 在 
物 联网 领域 的 应 用 。 

(2) SaaS 模式 在 物 联 网 中 的 应 用 。SaaS 模式 的 存在 由 来 已 久 . 被 云 计算 概念 重新 包装 后 ,除了 可 
以 利用 云 计 算 的 技术 (如 IaaS 技术 ) 外 ,其 没有 本 质 上 的 变化 。 通 过 SaaS 模式 ,实现 物 联网 应 用 提供 的 
服务 被 多 个 客户 共享 使 用 。 这 为 各 类 行业 应 用 和 信息 共享 提供 了 有 效 途径 ,也 为 高 效 利 用 基础 设施 资 
源 、 实 现 高 性 价 比 的 大 量 数据 处 理 提供 了 可 能 。 在 物 联网 范畴 内 出 现 的 一 些 变 化 是 ,SaaS 应 用 在 感知 
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层 进行 了 拓展 ,它们 依赖 感知 层 的 各 种 设备 采集 了 大 量 数据 ,并 以 这 些 数据 为 基础 进行 关联 分 析 和 处 
理 ,向 最 终 用 户 提供 业务 功能 和 服务 。 

(3) PaaS 模式 在 物 联网 中 的 应 用 。 研 究 机 构 Gartner 把 PaaS 分 成 两 类 : APaaS( Application 
PaaS, 应 用 部 署 和 运行 平台 ) 和 IPaaS(Integration PaaS, 集 成 平台 )。APaaS 主要 为 应 用 提供 运行 环境 
和 数据 存储 ; IPaaS 主要 用 于 集成 和 构建 复合 应 用 。 人 们 常 说 的 PaaS 平台 大 都 指 APaaS, 如 
Force. com 和 GoogleAppEngine。 在 物 联网 范畴 内 ,由 于 构建 者 本 身价 值 取向 和 实现 目标 的 不 同 ,因此 
PaaS 模式 存在 不 同 的 应 用 模式 和 应 用 方向 。 

从 目前 来 看 , 物 联网 与 云 计算 的 结合 是 必然 趋势 ,但 是 物 联 网 与 云 计算 的 结合 也 需要 水 到 渠 成 。 不 
管 是 PaaS 模式 还 是 SaaS 模式 , 物 联网 的 应 用 都 需要 在 特定 的 环境 中 才能 发 挥 应 有 的 作用 。 

4. 大 数据 技术 

对 于 大 数据 ,研究 机 构 Gartner 给 出 了 这 样 的 定义 : 大 数据 是 海量 ,高 增长 率 和 多 样 化 的 信息 资产 
它 需要 新 处 理 模式 才能 获得 更 强 的 决策 力 、 洞 察 发 现 力 和 流程 优化 能 力 。 大 数据 技术 的 战略 意义 不 在 
于 掌握 庞大 的 数据 信息 ,而 在 于 对 这 些 有 意义 的 数据 进行 专业 化 处 理 。 换 言 之 ,如 果 把 大 数据 比 作 一 种 
产业 ,那么 这 种 产业 实现 一 利 的 关键 在 于 提高 对 数据 的 加 工 能 力 , 通 过 加 工 实现 数据 的 增值 。 

从 技术 上 看 ,大 数据 与 云 计算 的 关系 就 像 一 枚 硬币 的 正 反 面 一 样 密 不 可 分 。 大 数据 必然 无 法 用 单 
台 的 计算 机 进行 处 理 , 必 须 采用 分 布 式 架构 。 它 的 特色 在 于 对 海量 数据 进行 分 布 式 数据 挖掘 ,但 它 必须 
依托 云 计算 的 分 布 式 处 理 , 分 布 式 数据 库 、 云 存储 和 虚拟 化 技术 。 随 着 云 时 代 的 来 临 ,大 数据 也 引起 了 
越 来 越 多 的 关注 。 著 云 台 的 分 析 师 团队 认为 ,大 数据 通常 用 来 形容 一 个 公司 创造 的 大 量 非 结构 化 数据 
和 半 结 构 化 数据 ,这 些 数据 下 载 到 关系 数据 库 用 于 分 析 时 会 花费 过 多 时 间 和 金钱 。 大 数据 分 析 常 和 去 
计算 联系 在 一 起 ,因为 实时 的 大 型 数据 集 分 析 需 要 像 MapReduce 一 样 的 框架 来 向 数 十 、 数 百 甚至 数 千 
的 计算 机 分 配 工 作 。 

大 数据 需要 特殊 的 技术 ,以 有 效 地 处 理 某 眉 时 间 内 的 数 “| 一 [分 所 |] 
据 。 适 用 于 大 数据 的 技术 包括 大 规模 并 行 处 理 数据 库 ` 数 据 sta 
挖掘 、 分 布 式 文件 系统 ,分 布 式 数据 库 、 云 计算 平台 互联 网 分 布 式 数据 库 
和 可 扩展 的 存储 系统 。 物 联网 通过 智能 硬件 为 云 计算 提供 
大 量 的 数据 。 物 联网 、 云 计算 与 大 数据 技术 之 间 的 关系 如 图 


i 
1-3 所 示 。 物 联网 依靠 智能 硬件 接 入 , 云 计算 包括 云 存 储 虚 物 联网 智能 硬件 接 入 


拟 化 ,分 布 式 处 理 以 及 分 布 式 数 据 库 、 大 数据 技术 包括 分 布 
图 1-3 物 联网 . 云 计算 与 大 数据 


EBEN. 技术 之 间 的 关系 
1.2.8 物 联网 语义 


物 联网 系统 分 为 四 个 层面 : 感知 层 、 传 输 层 ,支撑 层 和 应 用 层 。 感 知 层 主要 是 对 物体 进行 识别 或 数 
据 采集 ; 传输 层 是 通过 现 有 的 通信 网 络 将 信息 进行 可 靠 传输 ; 支撑 层 和 应 用 层 则 是 对 采集 的 数据 进行 
智能 处 理 或 展示 。 基 于 物理 、 化 学 .生物 等 技术 发 明 的 传感器 标准 已 经 有 多 项 专利 。 而 传输 层 的 各 种 通 
信 标 准 也 已 基本 成 熟 ,建立 新 的 物 联网 通信 标准 难度 较 大 ,可 行 性 较 小 。 因 此 . 物 联 网 标准 的 关键 和 亚 
待 统一 的 是 关于 应 用 层 的 标准 ,而 其 中 尤 以 数据 表达 、 交 换 和 处 理 标 准 为 核心 。 

目前 ,针对 物 联 网 应 用 层 的 数据 交换 标准 主要 有 PML(Physical Markup Language, 实 体 标 记 语 
言 )、.EDDL(Electronic Device Description Language, 电 子 设备 描述 语言 );、M2M XML(M2M eXtensible 
Markup Language. M2M 可 扩展 标记 语言 ) 和 NGTP(Next Generation Telematics Protocol, 下 一 代 车 
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载 智能 通信 协议 ) 等 。 其 中 ,PML 是 电子 产品 代码 在 物 联 网 中 交换 信息 的 共同 语言 ,用 来 描述 人 及 机 器 
都 可 以 使 用 的 自然 物体 的 标准 。EDDL 可 以 描述 现场 设备 中 的 数据 ,用 于 工程 .调试 ,监视 运行 和 诊断 。 
M2M XML 是 一 种 用 于 终端 设备 间 的 通信 协议 , 它 包 含 一 个 用 于 分 析 协 议 的 与 语义 无 关 的 Java API。 
NGTP 是 宝马 公司 推出 的 开放 式 车 载 智能 通信 协议 架构 平台 , 它 使 用 统一 .开放 的 接口 来 区 分 车 载 智能 
通信 服务 供应 链 的 各 个 环节 。 此 外 ,各 种 行业 标准 层出不穷 。 

可 以 看 出 , 现 有 的 物 联网 应 用 层 的 数据 交换 标准 大 多 是 针对 某 一 特定 领域 或 行业 业务 提出 的 ,有 一 
定 的 局 限 性 ,所 以 当前 物 联 网 缺少 的 是 一 个 统一 的 物 联网 数据 交换 标准 体系 。 欧 盟 有 关机 构 正 在 进行 
数据 交换 标准 融合 的 研究 ,目标 是 综合 考虑 相关 领域 已 有 的 基于 XML 的 数据 交换 标准 ,以 便 为 那些 在 
不 同 的 标准 中 语义 上 具有 等 价 性 的 数据 元 素 ( 尽 管 它们 可 能 有 不 同 的 名 字 ) 提 供 全 球 唯一 的 交叉 引用 方 
式 和 标识 结构 ,从 而 提炼 出 一 个 基础 的 元 数据 标准 ,把 这 个 标准 作为 物 联网 数据 交换 的 核心 ,那么 ,对 于 
不 同 的 行业 应 用 ,就 可 以 基于 元 数据 扩展 出 相应 的 行业 数据 交换 标准 。 

总 体 来 说 , 物 联网 的 标准 化 工作 已 经 得 到 了 业界 的 普遍 重视 ,但 对 于 应 用 层 的 标准 化 工作 来 说 , 需 
要 客观 分 析 物 联网 标准 的 整体 需求 ,从 国际 标准 、 国 家 标准 \ 行 业 标准 、 地 区 标准 等 多 个 层次 进行 统筹 设 
计 ; 还 需要 协调 各 个 标准 的 推进 策略 ,优化 资源 配置 。 

1. 物 联网 数据 交换 标准 的 语义 基础 是 本 体 

本 体 起 源 于 哲学 ,被 Neches 等 人 引入 计算 机 科学 领域 后 ,在 人 工 智能 .语义 Web、 软 件 工 程 以 及 信 
息 架 构 等 领域 得 到 了 广泛 应 用 。 本 体 最 流行 的 定义 是 Gruber 在 1993 年 给 出 的 , 即 本 体 是 概念 模型 明 
确 的 规范 说 明 。Studer 在 对 前 人 的 定义 进行 概括 后 提出 本 体 的 概念 包括 四 个 方面 : 一 是 概念 模型 , 它 
是 客观 世界 现象 的 抽象 模型 ,其 表示 的 含义 独立 于 具体 的 环境 状态 ; 二 是 明确 ,所 使 用 的 概念 及 使 用 这 
些 概念 的 约束 都 有 明确 的 定义 ; 三 是 形式 化 ,本 体 的 表示 是 形式 化 的 ,可 以 被 计算 机 处 理 ; 四 是 共 
享 ,本 体 中 体现 的 是 共同 认可 的 知识 .反映 的 是 相关 领域 中 公认 的 概念 集 , 它 所 针对 的 是 团体 而 不 是 
个 体 。 

本 体 的 目标 是 获取 相关 的 领域 知识 ,提供 对 该 领域 知识 的 共同 理解 ,确定 该 领域 内 共同 认可 的 词 
汇 , 并 从 不 同 层次 的 形式 化 模式 上 ,给 出 这 些 词 汇 ( 术 语 ) 和 词汇 间 相 互 关 系 的 明确 定义 。 所 以 ,本 体 是 
具有 不 同 知识 表示 Web 应 用 系统 之 间 进 行 数据 或 知识 交换 共享 的 基础 结构 。 通 过 定义 共享 和 公共 的 
领域 知识 ,本 体 可 帮助 在 机 器 之 间或 机 器 与 人 之 间 进 行 更 加 精确 的 交流 ,实现 相互 之 间 的 语义 交换 ,而 
不 只 是 语法 级 的 交互 。 

按照 领域 依赖 程度 ,Guarino 将 本 体 划分 为 四 类 : 一 是 顶级 本 体 ,用 于 描述 通用 的 概念 和 概念 之 间 
的 关系 ,如 时 间 、 空 间 、 物 质 、 对 象 、 事 件 、 动 作 等 ,顶级 本 体 独 立 于 特定 的 问题 和 领域 ,与 具体 的 应 用 无 
Xs 二 是 领域 本 体 ,用 于 描述 特殊 领域 (如 教育 或 金融 ) 中 的 概念 . 即 陈述 性 知识 ; 三 是 任务 本 体 , 用 于 描 
述 特定 任务 或 活动 (如 入 学 或 取款 ) 中 的 概念 , 即 过 程 性 知识 ; 四 是 应 用 本 体 ,可 通过 进一步 特殊 化 领域 
本 体 和 任务 本 体 , 将 其 用 于 描述 既 依 赖 于 特定 领域 又 依赖 于 特定 任务 的 概念 ,这 些 概念 通常 对 应 于 领域 
个 体 执行 特定 活动 (如 学 生 和 人 学 或 客户 取款 ?时 所 扮演 的 角色 。Daniel 等 人 利用 现 有 的 本 体 创建 工具 ， 
构建 了 通用 的 语义 传感器 本 体 , 实 现 了 大 型 的 语义 传感器 网 络 基础 设施 。 

本 体 从 底层 向 上 分 为 项 级 本 体 、 领 域 本 体 、 任 务 本 体 以 及 应 用 本 体 .这 些 不 同 层次 的 本 体 可 提供 整 
个 世界 的 共性 描述 ,而 物 联网 正 是 要 将 世界 连接 起 来 。 

首先 , 物 联网 所 连接 的 各 种 物体 都 处 在 同一 个 世界 中 .它们 都 具有 某 些 共 同 的 特点 , 即 人 们 对 于 这 
个 世界 的 基本 认识 ,如 时 空 ,物质 .事件 和 行为 等 ,所 以 物 联 网 数据 交换 标准 体系 的 基础 是 项 级 本 体 标 
准 。 其 次 , 物 联网 各 个 垂直 的 应 用 领域 都 有 特殊 性 。 具 体 到 每 一 个 领域 ,都 有 可 能 有 必要 发 展 一 套 依 
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托 于 领域 本 体 的 标准 。 但 是 ,很 多 类 型 的 业务 词汇 和 流程 是 可 以 跨越 多 个 垂直 应 用 领域 而 公用 的 ,所 
以 ,还 有 必要 发 展 跨 领域 的 物 联网 任务 本 体 标准 , 即 某 个 领域 的 本 体 标准 可 能 构建 于 多 个 任务 本 体 标 准 
之 上 ,而 某 个 任务 本 体 也 有 可 能 被 多 个 领域 本 体 所 引用 。 最 后 ,具体 到 每 个 企业 、 组 织 甚至 个 人 ,它们 针 
对 自身 的 物品 行为、 过程 等 ,也 可 以 建立 起 基于 顶级 本 体 、 领 域 本 体 和 任务 本 体 的 应 用 本 体 标准 ,以 供 
其 他 个 体 在 与 自身 发 生 信息 交换 时 共享 这 些 事先 定义 好 的 内 容 。 

构建 本 体 时 要 确定 本 领域 内 公认 的 词汇 ,建立 对 某 个 领域 知识 的 共同 理解 和 相关 描述 ,并 能 够 给 出 
领域 词汇 和 词汇 之 间 的 相互 关系 在 不 同 层次 的 形式 、 模 式 上 的 明确 定义 ,从 而 能 够 完整 地 提取 领域 知 
识 。 本 体 层 首先 需要 对 基本 的 类 /属性 进行 描述 ,同时 还 必须 对 本 体 以 及 本 体 之 间 的 关系 进行 描述 ,是 
语义 网 的 核心 层 。 本 体 层 的 专用 描述 语言 规范 也 出 现 许多 ,得 到 大 家 认可 的 有 DAML(DARPA Agent 
Markup Language. DARPA 代理 标记 语言 )、.SHOL(Simple HTML Ontology Language. 简单 HTML 
本 体 语 言 ) .OILCOntology Inference Language, 本 体 推 理 语言 ) 以 及 DAML 二 OIL。 目 前 ,学 术 界 使 用 
最 多 的 本 体 描 述 语言 是 由 W3C 组 织 推 荐 的 OWL(Ontology Web Language, 本 体 Web 语言 ) 。 

2. 物 联网 数据 交换 标准 的 语法 基础 是 XML 

ASN. 1 是 1SO 和 ITU-T 的 联合 标准 ,ASN. 1 本 身 只 定义 了 表示 信息 的 抽象 句法 ,但 是 没有 限定 
其 编码 的 方法 。 各 种 ASN. 1 编码 规则 提供 了 由 ASN. 1 描述 其 抽象 句法 数据 值 的 传送 语法 (具体 表 
达 )。 标 准 的 ASN. 1 编码 规则 有 BER (Basic Encoding Rules. 基本 编码 规则 )、CER (Canonical 
Encoding Rules, 规 范 编码 规则 )、DER(Distinguished Encoding Rules, 唯 一 编码 规则 )、PER (Packed 
Encoding Rules, 压 缩编 码 规则 ) 和 XER(XML Encoding Rules. XML 编码 规则 ) 。 

XML 是 W3C 组 织 于 1998 年 推出 的 一 种 用 于 数据 描述 的 元 标记 语言 标准 。 作 为 SGML 
(Standard Generalized Markup Language, 标 准 通用 标识 语言 ) 的 一 个 简化 子 集 , 它 结合 了 SGML 丰富 
的 功能 和 HTML 的 简单 易 用 ,同时 具有 可 扩展 性 、 自 描述 性 、 开 放 性 、 互 操作 性 、 可 支持 多 国语 言 等 特 
点 ,因而 得 到 了 广泛 的 支持 与 应 用 。 对 于 作为 物 联网 数据 交换 标准 的 格式 来 说 ,XML 具有 以 下 显著 

(1) 可 定义 行业 或 领域 标记 语言 。XML 可 以 用 Schema 来 定义 ,一 份 遵循 Schema 定义 的 XML 文 
档 才 是 有 效 的 。 因 此 ,XML 可 以 针对 不 同 应 用 建立 相关 的 标准 语言 ,例如 化 学 标记 语言 .数学 标记 语 
言 .语音 标记 语言 等 ,包括 目前 物 联 网 中 很 多 已 经 存在 的 标准 ,都 是 基于 XML 定义 的 。 

(2) 具有 结构 化 的 通用 数据 格式 。XML 使 用 树 形 目录 结构 形式 ,可 以 自行 定义 文字 标签 并 指定 元 
素 间 的 关系 ,同时 它 也 是 W3C 公开 的 一 种 数据 格式 ,没有 版 权 的 使 用 限制 ,因而 十 分 适合 作为 不 同 应 用 
程序 之 间 的 信息 交换 格式 。 

G) 可 提供 整套 方案 。XML 拥有 一 整套 技术 体系 ,如 可 扩展 样式 表 语 言 (XSL) XML 数据 查询 技 
术 (xQuery) 以 及 文档 对 象 模型 (DOM) 等 。 

(4) 在 语法 上 结构 化 信息 表达 能 力 和 本 体 在 语义 上 透明 性 之 间 的 优势 互补 ,为 物 联网 数据 交换 标 
准 的 建立 提供 了 很 好 的 解决 思路 。 

基于 上 述 内 容 , 物 联网 数据 交换 标准 应 以 XML 为 语法 格式 ,以 标准 化 的 本 体 为 语义 共识 。 按 照 本 
体 的 分 类 , 物 联 网 数据 交换 标准 体系 应 以 顶级 本 体 为 基础 ,以 纵向 的 领域 本 体 和 横向 的 任务 本 体 为 支 
撑 , 建 立 起 各 种 不 同 的 应 用 本 体 标准 ,其 整个 物 联 网 数据 交换 标准 体系 示意 如 图 1-4 所 示 。 

3. 物 联网 数据 互 操作 是 RDF 

RDF(Resource Description Framework, 资 源 描述 框架 ) 模 型 和 RDF Schema 是 语义 网 体系 结构 框 
架 的 互 操 作 层 。 
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项 级 本 体 层 项 级 本 体 标准 
领域 本 体 标准 领域 本 体 标准 
领域 和 任务 本 体 层 
任务 本 体 标准 任务 本 体 标准 
[ I D 
应 用 本 体 层 。 “| 应 用 本 体 标准 应 用 本 体 标准 ”应 用 本 体 标准 





图 1-4 物 联网 数据 交换 标准 体系 示意 图 


语义 数据 的 定义 和 互 操作 由 这 层 来 完成 。W3C 组 织 研 究 开发 了 用 来 描述 资源 及 其 之 间 关系 的 
RDF 规范 。RDF 通常 采用 三 元 组 来 表示 互联 网 上 的 各 种 信息 资源 、 属 性 及 其 值 ,具体 表示 为 RDF 的 声 
明 , 即 某 个 资源 的 某 个 属性 (谓词 ?的 值 是 客体 ( 某 个 资源 或 者 原生 值 ) 。 

RDF Schema 是 在 RDF 的 基础 上 .引入 了 描述 类 和 属性 的 能 力 , 它 定义 了 属性 的 定义 域 与 值 域 类 
以 及 属性 之 间 的 关系 等 ,就 像 是 一 本 大 词典 ,定义 了 计算 机 可 以 理解 的 词汇 ,计算 机 在 分 析 执 行程 序 的 
时 候 ,直接 在 词典 中 查询 这 些 定义 就 可 以 知道 数据 所 包含 的 语义 。 

物 联网 中 的 数据 语义 不 同 ,虽然 可 以 通过 XML、 本 体 等 技术 来 构建 一 套 物 联网 数据 交换 标准 体系 ， 
并 成 立 相关 标准 组 织 来 进行 管理 .但 这 只 能 在 一 定 程度 上 解决 一 定 范围 内 的 数据 交换 问题 ,而 不 可 能 也 
没 必要 建立 一 整套 全 面 的 数据 交换 标准 ,并 要 求 所 有 参与 者 都 要 符合 这 个 标准 。 所 以 ,整个 物 联网 数据 
交换 标准 体系 应 该 是 由 少数 几 个 顶级 本 体 标准 、 大 多 数 领域 本 体 标准 与 任务 本 体 标准 ,以 及 数量 众多 的 
应 用 本 体 标准 组 成 。 正 因为 如 此 .还 需要 在 物 联网 的 各 个 终端 的 必要 位 置 上 ,设置 恰当 的 转换 器 或 者 接 
口 , 从 而 实现 针对 同一 对 象 .应 用 或 业务 而 语义 不 同 的 标准 之 间 的 转换 。 


1.2.4 M2M 技术 


随 着 技术 的 发 展 , 越 来 越 多 的 设备 具有 了 通信 和 联网 能 力 , 这 将 使 得 所 有 物体 联网 逐步 变 为 现实 。 
人 与 人 之 间 的 通信 需要 更 加 直观 、 精 美的 界面 和 更 丰富 的 多 媒体 内 容 , 而 M2M 的 通信 更 需要 建立 一 个 
统一 .规范 的 通信 接口 和 标准 化 的 传输 内 容 。 另 外 ,通信 网 络 技术 的 出 现 和 发 展 给 社会 生活 带 来 了 极 大 
的 变化 。 人 与 人 之 间 可 以 更 加 快捷 地 沟通 ,信息 的 交流 更 顺畅 。 但 是 ,目前 仅仅 是 计算 机 和 其 他 一 些 
IT 类 设备 具备 这 种 通信 和 网 络 能 力 。 众 多 的 普通 机 器 设备 几乎 不 具备 联网 和 通信 能 力 , 如 家 电 、 车 辆 、 
自动 售 货 机 、 工 厂 设备 等 。 

ETSI 是 国际 上 较 早 系统 地 展开 M2M 相关 研究 的 标准 化 组 织 ,2009 年 初 成 立 了 专门 的 工作 组 负责 
统筹 M2M 的 研究 . 旨 在 制定 一 个 水 平 化 的 、 不 针对 特定 M2M 应 用 的 端 到 端 解 决 方案 的 标准 。 其 研究 
范围 可 以 分 为 两 个 层面 : 第 一 个 层面 是 针对 M2M 应 用 用 例 的 收集 和 分 析 ; 第 二 个 层面 是 在 用 例 研究 
的 基础 上 ,开展 与 应 用 无 关 的 M2M 业务 需求 分 析 、 网 络 体系 架构 定义 、 数 据 模型 .接口 和 过 程 设计 等 
THE» 

M2M 技术 的 目标 是 使 所 有 机 器 设备 都 具备 联网 和 通信 能 力 ,其 核心 理念 是 所 有 物体 连接 网 络 。 
M2M 技术 具有 非常 重要 的 意义 ,有 广阔 的 市 场 和 应 用 前 景 ,推动 着 社会 生产 和 生活 方式 新 一 轮 的 变革 。 
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M2M 是 一 种 理念 ,也 是 所 有 增强 机 器 设备 通信 和 网 络 能 力 技术 的 总 称 。 人 与 人 之 间 的 沟通 很 多 也 是 通 
过 机 器 实现 的 ,例如 ,通过 手机 电话、 计算 机 、 传 真 机 等 机 器 设备 之 间 的 通信 来 实现 人 与 人 之 间 的 沟通 。 
另外 一 类 技术 是 专 为 机 器 和 机 器 建立 通信 而 设计 的 ,如 许多 智能 化 仪器 仪表 都 带 有 通用 接口 ,增强 了 仪 
器 与 仪器 之 间 、 仪 器 与 计算 机 之 间 的 通信 能 力 。 目 前 ,多 数 的 机 器 和 传感器 具备 本 地 或 者 远程 的 通信 与 
联网 能 力 。 























M2M 系统 框架 从 数据 流 的 角度 考虑 .在 M2M 技术 中 ,信息 总 是 以 相同 的 ES 
顺序 流动 。 在 这 个 基本 的 框架 内 ,涉及 多 种 技术 问题 和 选择 。 例 如 ,机 器 如 何 通信 和 网 络 
连接 网 络 ? 使 用 什么 样 的 通信 方式 ? 数据 如 何 整合 到 原 有 或 者 新 建立 的 信息 M2M 硬 件 
系统 中 ? 但 是 ,无 论 哪 一 种 M2M 技术 与 应 用 ,都 涉及 五 个 重要 的 技术 部 分 , 即 ne 
机 器 .M2M 硬件 .通信 网 络 . 中 间 件 .应 用 ,如 图 1-5 所 示 。 ET 
智能 化 机 器 使 机 器 * 开 口 说 话 ", 让 机 器 具备 信息 感知 .信息 加 工 (计算 能 pu m 


Jp ,无 线 通信 能 力 。M2M 硬件 进行 信息 的 提取 ,从 各 种 机 器 /设备 那里 获取 
数据 ,并 传送 到 通信 网 络 。 通 信 网 络 将 信息 传送 到 目的 地 。 中 间 件 在 通信 网 络 和 IT 系统 间 起 桥接 作 
用 。 应 用 对 获得 数据 进行 加 工分 析 ,为 决策 和 控制 提供 依据 。 

因此 ,M2M 不 是 简单 的 数据 在 机 器 和 机 器 之 间 的 传输 ,更 重要 的 是 , 它 是 机 器 和 机 器 之 间 的 一 种 智 
能 化 ,交互 式 的 通信 。 也 就 是 说 ,即使 人 们 没有 实时 发 出 信号 ,机 器 也 会 根据 既定 程序 主动 进行 通信 ,并 
根据 所 得 到 的 数据 智能 化 地 做 出 选择 ,对 相关 设备 发 出 正确 的 指令 。 可 以 说 ,智能 化 ,交互 式 成 为 M2M 
有 别 于 其 他 应 用 的 典型 特征 ,这 一 特征 下 的 机 器 也 被 赋予 了 更 多 的 “思想 ”和 “智慧”。 

M2M 是 将 数据 从 一 台 终 端 传送 到 另 一 台 终端 ,也 就 是 机 器 与 机 器 的 对 话 。 但 是 ,从 广义 上 M2M 
可 代表 机 器 对 机 器 .人 对 机 器 、 机 器 对 人 、 移 动 网 络 对 机 器 之 间 的 连接 与 通信 , 它 涵盖 了 所 有 实现 在 人 、 
机 器 .系统 之 间 建 立 通信 连接 的 技术 和 手段 。 

M2M 产品 主要 由 三 部 分 构成 : 第 一 ,无 线 终端 ,可 以 是 特殊 的 行业 应 用 终端 ,也 可 以 是 通常 的 手机 
或 笔记 本 电脑 ; 第 二 ,传输 通道 ,从 无 线 终端 到 用 户 端的 行业 应 用 中 心 之 间 的 通道 ; 第 三 ,行业 应 用 中 
心 , 也 就 是 终端 上 传 数据 的 汇聚 点 ,对 分 散 的 行业 终端 进行 监控 。 其 特点 是 行业 特征 强 , 用 户 自行 管理 ， 
而 且 可 位 于 企业 端 或 者 可 以 托管 。 

M2M 应 用 市 场 正 在 全 球 范围 内 快速 增长 , 随 着 通信 设备 ,管理 软件 等 相关 技术 的 深化 ,M2M 产品 
成 本 的 下 降 ,M2M 业务 将 逐渐 走向 成 熟 。 目 前 .中 国 、 美 国 和 加 拿 大 等 国 已 经 实现 MM 产品 在 安全 监 
测 、 机 械 服 务 、 维 修业 务 、 自 动 售 货机 公共 交 通 系统 、 车 队 管理 .工业 流程 自动 化 .电动 机械 ,城市 信息 化 
等 领域 的 应 用 。 


1.3” 物 联网 的 发 展 


1.3.1 两 化 融合 及 互联 网 二 


两 化 融合 是 指 电子 信息 技术 广泛 应 用 到 工业 生产 的 各 个 环节 ,信息 化 成 为 工业 企业 经 营 管理 的 常 
规 手 段 。 信 息 化 进程 和 工业 化 进程 不 再 相互 独立 进行 .不 再 是 单方 的 带动 和 促进 关系 ,而 是 两 者 在 技 
术 、 产 品 、 管 理 等 各 个 层面 相互 交融 ,彼此 不 可 分 割 ,并 催生 工业 电子 .工业 软件 .工业 信息 服务 等 新 产 
业 。 两 化 融合 是 工业 化 和 信息 化 发 展 到 一 定 阶段 的 必然 产物 。 信 息 化 与 工业 化 主要 在 技术 、 产 品 、 业 
务 .产业 四 个 方面 进行 融合 。 也 就 是 说 ,两 化 融合 包括 技术 融合 .产品 融合 .业务 融合 .产业 衍生 四 个 方 
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面 。 物 联网 在 制造 业 的 两 化 融合 可 以 从 以 下 四 个 角度 理解 : 生产 自动 化 ,将 物 联网 技术 融入 制造 业 生 
产 , 如 工业 控制 技术 .柔性 制造 .数字 化 工艺 生产 线 等 ; 产品 智能 化 ,在 制造 业 产品 中 采用 物 联网 技术 提 
高 产品 技术 含量 ,如 智能 家 电 、 工 业 机 器 人 、 数 控 机 床 等 ; 管理 精细 化 ,在 企业 经 营 管理 活动 中 采用 物 联 
网 技术 ,如 制造 执行 系统 .产品 追溯 .安全 生产 的 应 用 ; 产业 先进 化 ,制造 业 产 业 和 物 联 网 技术 融合 优化 
产业 结构 ,促进 产业 升级 。 

2015 年 3 月 5 日 第 十 二 届 全 国人 民 代 表 大 会 第 三 次 会 议 上 ,李克强 总 理 在 政府 工作 报告 中 首次 提 
出 “互联 网 十 ”行动 计划 。 李 克 强 总 理 所 提 的 “互联 网 十 ”与 较 早 相关 互联 网 企业 讨论 聚焦 的 “互联 网 改造 
传统 产业 ” 相 比 已 经 有 了 进一步 的 深入 和 发 展 。 李 克 强 总 理 在 政府 工作 报告 中 首次 提出 的 “互联 网 十 ” 实 
际 上 是 创新 2.0 下 互联 网 发 展 新 形态 、 新 业态 ,是 知识 社会 创新 2.0 推动 下 的 互联 网 形态 演进 。 

伴随 知识 社会 的 来 临 ,驱动 当今 社会 变革 的 不 仅仅 是 无 所 不 在 的 网 络 ,还 有 无 所 不 在 的 计算 、 无 所 
不 在 的 数据 、 无 所 不 在 的 知识 。“ 互 联网 十 "不 仅仅 是 互联 网 移动 了 、 泛 在 了 、 应 用 于 某 个 传统 行业 了 ,更 
是 无 所 不 在 的 计算 、 数 据 、 知 识 造 就 了 无 所 不 在 的 创新 ,推动 了 知识 社会 以 用 户 创 新 、 开 放 创 新 、 大 众 
创新 .协同 创新 为 特点 的 创新 2.0, 改 变 了 我 们 的 生产 ,工作 、 生 活 方式 ,也 引领 了 创新 驱动 发 展 的 新 
常态 。 

新 一 代 信 息 技术 催生 了 创新 2.0, 而 创新 2.0 又 反 过 来 作用 于 新 一 代 信 息 技 术 形 态 的 形成 与 发 展 ， 
重 塑 了 物 联网 \ 云 计算 、 大 数据 等 新 一 代 信息 技术 的 新 形态 。 新 一 代 信息 技术 的 发 展 又 推动 了 创新 2. 0 
模式 的 发 展 和 演变 ,Living Lab( 生 活 实验 室 、 体 验 实验 区 )、Fab Lab( 个 人 制造 实验 室 、 创 客 )、AIP(* 三 
验 ” 应 用 创新 园区 )、WiKi( 维 基 模 式 ) 、Prosumer( 产 消 者 )、Crowdsourcing( 众 包 ) 等 典型 创新 2. 0 模式 
不 断 涌现 。 新 一 代 信 息 技术 与 创新 2. 0 的 互动 与 演进 推动 了 “互联 网 十 ”的 发 展 。 关 于 知识 社会 环境 下 
新 一 代 信息 技术 与 创新 2. 0 的 互动 演进 可 参阅 (创新 2. 0 研究 十 大 热点 》。 互 联网 随 着 信息 通信 技术 的 
深入 应 用 带 来 了 创新 形态 演变 ,其 本 身 也 在 变化 并 与 行业 新 形态 相互 作用 共同 演化 ,如 同 以 工业 4. 0 为 
代表 的 新 工业 革命 以 及 以 Fab Lab 与 创 客 为 代表 的 个 人 设计 .个 人 制造 群体 创造 。 可 以 说 “互联 网 十 ” 
是 新 常态 下 创新 驱动 发 展 的 重要 组 成 部 分 ,是 物 联网 发 展 的 重大 驱动 力量 。 

“互联 网 十 ”是 创新 2.0 下 的 互联 网 发 展 新 形态 .新 业态 ,是 知识 社会 创新 2. 0 推动 下 的 互联 网 形态 
演进 。“ 互 联网 十 ”代表 一 种 新 的 经 济 形态 , 即 充分 发 挥 互 联网 在 生产 要 素 配 置 中 的 优化 和 集成 作用 ,将 
互联 网 的 创新 成 果 深 度 融 合 于 经 济 社会 各 领域 之 中 ,提升 实体 经 济 的 创新 力 和 生产 力 ,形成 更 广泛 的 以 
互联 网 为 基础 设施 和 实现 工具 的 经 济 发 展 新 形态 。“ 互 联网 十 ”行动 计划 将 重点 促进 以 云 计算 、 物 联网 
和 大 数据 为 代表 的 新 一 代 信息 技术 与 现代 制造 业 、 生 产 性 服务 业 的 融合 创新 ,发 展 壮大 新 兴业 态 , 打 造 
新 的 产业 增长 点 ,为 大 众 创业 、 万 众 创新 提供 环境 ,为 产业 智能 化 提供 支撑 ,增强 新 的 经 济 发 展 动力 , 促 
进 国民 经 济 提 质 增 效 升级 。 


1.3.2” 物 联网 联盟 


2014 年 ,很 多 具有 强大 影响 力 的 国内 外 企业 组 建 了 物 联网 联盟 ,为 未 来 物 联网 领域 的 标准 规范 疯 
定 了 基础 ; 另外 ,联盟 之 间 的 许多 工作 有 重复 之 处 ,并 且 一 个 企业 参与 了 多 个 联盟 ,如 何 进一步 融合 是 
未 来 联盟 之 间 发 展 的 重点 。 下 面 简单 介绍 目前 物 联 网 行业 技术 标准 的 重要 联盟 。 

1. 开放 互联 联盟 /开放 互联 基金 会 

2014 年 7 月 成 立 了 开放 互联 联盟 (Open Interconnect Consortium, OIC) ,该 联盟 最 初 有 戴尔 .惠普 、 
英特尔 .联想 和 三 星 等 诸多 会 员 。2016 年 10 月 .OIC 和 AllSeen 联盟 同时 宣布 双方 正式 合并 ,成 立 开 放 
互联 基金 会 (Open Connectivity Foundation. OCF) ,合并 后 双方 将 遵循 OCF 的 名 称 和 运作 规则 。OCF 
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成 为 全 球 物 联 网 行业 最 大 的 标准 组 织 , 并 有 望 成 为 国际 物 联网 标准 的 实际 制定 者 ,推动 物 联 网 产业 形成 
统一 的 产品 标准 ,打造 更 好 的 用 户 体验 。 目 前 ,OCF 正 组 织 撰写 一 系列 开源 标准 。 在 这 些 标准 的 帮助 
下 ,各 类 联网 设备 将 能 寻找 、 隔 离 和 确认 彼此 ,进行 沟通 、 相 互 影 响 、 完 成 数据 交换 。 该 联盟 在 2015 年 末 
发 布 了 面向 开发 者 的 首 个 开源 代码 。 

2. IEEE P2413 项 目 

技术 标准 的 传统 权威 IEEE 发 起 了 整顿 IoT 领域 的 P2413 项 目 ,力图 统一 物 联网 技术 标准 ,解决 业 
内 在 标准 制定 上 的 重复 浪费 工作 。2014 4E 7 J] IEEE P2413 项 目 召集 23 家 供应 商 和 其 他 相关 方 举行 
了 首次 会 议 ,希望 制定 一 整套 明确 的 物 联网 书面 标准 。 但 是 ,以 物 联网 的 快速 发 展 势头 ,IEEE 这 样 的 预 
订 上 日 程 实在 太 过 漫长 。 可 能 等 到 IEEE 的 标准 解决 方案 面世 时 ,制造 商 与 供应 商 推 出 的 事实 标准 或 已 
被 业界 默认 接受 。 目 前 ,该 工作 组 的 供应 商 和 组 织 机 构 包括 思 科 、 华 为 .通用 电气 甲骨文、 高 通 和 
ZigBee 联盟 等 。 

3. 工业 互联 网 联盟 

这 家 机 构 于 2014 年 3 月 正式 成 立 , 其 原始 成 员 为 AT&T、 思 科 、 通 用 电气 .IBM 和 英特尔 。 该 联盟 
现 有 逾 百名 成 员 , 华 为 ,微软 ,三 星 等 业内 知名 企业 均 在 其 中 。 其 着 重 于 各 家 企业 的 物 联 网 建设 及 策略 ， 
并 未 着 力 制定 行业 标准 ,而 是 与 认证 机 构 合作 ,以 求 确保 各 商业 领域 的 物 联网 技术 融会 贯通 。 其 宗旨 是 
让 多 家 正在 开发 IoT 与 M2M 技术 的 企业 实现 共同 协作 、 相 互 影 响 ,这 涉及 界定 基本 标准 要 求 、 参 考 架 
构 和 概念 证 明 的 问题 。 

4. AllSeen 技术 联盟 

AllSeen 技术 联盟 诞生 于 2013 年 12 月 ,目前 拥有 近 200 家 会 员 企 业 . 既 有 高 通 、 思 科 、TP-LINK、 
Silicon Image, Technicolor, Microsoft 这 类 软 硬 件 厂 商 ,也 有 海尔 、LG HA F EN Electrolux 等 消费 类 
电子 产品 厂商 。AllSeen 技术 联盟 的 创始 会 员 高 通 公司 对 其 最 为 重要 ,该 协会 的 开源 软件 框架 
AllJoyn, 是 基于 高 通 的 代码 和 技术 平台 创建 的 。AllSeen 技术 联盟 的 目标 是 让 配置 不 同 操作 系统 和 通 
信和 网 络 协议 的 家 用 、 商 务 设备 实现 协作 互助 。2015 年 3 月 ,Microsoft 公司 宣布 Windows 10 全 面 支持 
AllJoyn 技术 并 推出 适用 于 AllJoyn 的 工具 包 。 该 联盟 目前 已 经 与 OIC 合并 ,共同 致力 于 物 联网 互联 互 
通 协 议 的 构建 。 

5. Thread 联盟 

Thread 联盟 诞生 于 2014 年 7 月 ,谷歌 公司 旗下 智能 家 居 公 司 Nest 和 三 星 等 50 家 机 构 都 是 该 联 
盟 的 成 员 ,. 中 国家 电 企业 美的 集团 也 在 其 中 。Thread 是 一 种 基于 IP 的 安全 网 络 协议 ,用 来 连接 智能 产 
品 。 该 联盟 因此 得 到 先 发 优 势 , 其 协议 支持 已 上 市 的 芯片 .并 能 给 所 有 设备 都 分 配 一 个 IPv6 地 址 。 巾 
于 Thread 仅 定 义 联网 ,因此 为 支持 AllSeen 和 OIC 这 类 更 高 层面 的 标准 奠定 了 基础 ,该 联盟 已 经 进行 
产品 认证 。 

此 外 ,过 去 一 年 多 还 有 许多 机 构 和 行业 协会 在 物 联 网 领域 跃跃欲试 ,例如 ,通信 标准 化 协会 .国际 自 
动 化 协会 等 。 今 年 还 会 有 新 的 联盟 .企业 及 企业 联合 体 *“ 杀 ”入 物 联 网 。IoT 领域 已 有 许多 标准 认证 主 
体 , 有 的 机 构 致力 于 完善 补充 现 有 方案 标准 ,有 的 机 构 致力 于 技术 标准 冲突 解决 。 然 而 ,很 多 认证 标准 
的 冲突 与 重复 都 出 自 同一 联盟 内 部 的 企业 成 员 之 间 ,这 无 疑 加 大 了 标准 制定 的 难度 。 因 此 ,在 IoT 行业 
之 初 , 标 准 统一 的 可 能 性 很 小 ,必然 存在 多 个 标准 并 行 的 局 面 .以 保障 各 方 的 利益 。 


1.8.8 OCF 技术 
2016 年 底 , 全 球 物 联网 工业 界 组 成 OCF ,为 物 联网 发 展 迈 出 一 大 步 。 开 发 基于 OCF 技术 的 物 联网 
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通信 控制 管理 系统 ,是 整个 行业 发 展 的 希望 。 

OCF 认为 ,要 使 得 数 十 亿 的 连接 设备 (设备 电话、 计算 机 和 传感器 ) 能 够 相互 沟通 ,涉及 制造 商 、 操 
作 系 统 , 芯 片 组 及 底层 物理 传输 。OCF 构建 了 一 套 协议 规范 ,赞助 了 一 个 开源 项 目 Iotivity ,使 得 实现 这 
些 构 想 成 为 可 能 。 作 为 一 个 开放 的 协议 规范 ,OCF 将 为 物 联 网 市 场 带 来 巨大 的 机 遇 , 加 速 行业 创新 , 帮 
助 开发 者 和 企业 找到 解决 方案 。 对 于 消费 者 、 商 业 和 工业 界 来 说 ,OCF 将 确保 互 操作 性 。 

OCF 将 完成 定义 规范 、 认 证 产品 和 品牌 ,通过 一 个 开放 源码 Totivity 项 目 可 以 实现 可 靠 的 互 操作 
性 ,这 个 开放 的 协议 规范 允许 任何 人 来 实现 ,开发 者 很 容易 使 用 。 它 还 包括 可 预见 认证 设备 的 品牌 保护 
和 服务 级 别 的 互 操作 性 ,实现 了 应 用 程序 开发 者 和 设备 制造 商 的 产品 在 不 同 操作 系统 上 的 互 操作 ,如 
Android ,iOS, Windows,Linux 和 Tizen 等 。 

lotivity 是 一 个 开放 源 代码 的 软件 框架 ,实现 设备 到 设备 的 无 颖 连接 ,解决 物 联 网 的 各 种 需求 。 作 
为 一 个 全 新 的 开源 软件 系统 ,Iotivity 能 为 跨越 不 同 设备 的 分 布 式 应 用 ,提供 一 个 具有 移动 性 、 安 全 性 和 
动态 配置 的 环境 。 它 不 仅 能 解决 异 构 分 布 式 系统 的 固有 问题 ,还 能 解决 伴随 移动 性 系统 产生 的 随时 接 
和 问题 ,使 开发 人 员 能 集中 注意 力 解决 应 用 程序 的 核心 问题 。 因 此 ,OCF 技术 将 在 今后 的 物 联网 推广 
中 占有 重要 地 位 。 


1.4 RESTful 
REST(Representational State Transfer, 表 述 性 状态 转移 ) 是 一 种 软件 架构 风格 .设计 风格 ,而 不 是 


标准 , 它 只 是 提供 了 一 组 设计 原则 和 约束 条 件 ,主要 用 于 客户 端 和 服务 器 端 交互 类 的 软件 。 基 于 这 个 风 
格 设计 的 软件 可 以 更 简洁 ,更 有 层次 ,更 易于 实现 缓存 等 机 制 , 其 实现 的 位 置 如 图 1-6 所 示 。 
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图 1-6 REST 位 置 示意 图 


1.4.1 概述 


REST 描述 了 一 个 架构 样式 的 网 络 系统 .例如 ,Web 应 用 程序 首次 出 现在 2000 年 Roy Fielding 
(HTTP 规范 的 主要 编写 者 之 一 ) 的 博士 论文 中 。 在 目前 主流 的 三 种 Web 服务 交互 方案 中 ,REST 相 比 
于 SOAP(Simple Object Access Protocol ,简单 对 象 访问 协议 ) 以 及 XML-RPCCXML Remote Procedure 
Call. XML 远程 过 程 调 用 ) 更 加 简单 明了 ,无 论 是 对 URL( Uniform Resource Locator, 统 一 资源 定位 符 ) 
的 处 理 , 还 是 对 载荷 的 编码 .REST 都 倾向 于 用 更 加 简单 的 方法 设计 和 实现 。 值 得 注意 的 是 ,REST 并 
没有 一 个 明确 的 标准 ,而 更 像 是 一 种 设计 的 风格 ,交互 风格 如 图 1-7 Bron. 

REST 指 的 是 一 组 架构 约束 条 件 和 原则 ,满足 这 些 约束 条 件 和 原则 的 应 用 程序 或 设计 就 是 
RESTful。 
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客户 连接 中 客户 + 缓存 @ 服务 连接 CD 服务 + 缓存 © 
图 1-7 REST 交互 风格 


Web 应 用 程序 最 重要 的 REST 原则 是 ,客户 端 和 服务 器 端 之 间 的 交互 请 求 是 无 状态 的 。 从 客户 端 
到 服务 器 端的 每 个 请 求 都 必须 包含 理解 请 求 所 必需 的 信息 。 如 果 服 务 器 端 请 求 在 任何 时 间 点 重启 , 客 
户 端 不 会 得 到 通知 。 此 外 ,无 状态 请 求 可 以 由 任何 可 用 服务 器 端 回答 ,这 十 分 适合 云 计 算 之 类 的 环境 ， 
客户 端 可 以 缓存 数据 以 改进 性 能 。 

在 服务 器 端 ,应 用 程序 状态 和 功能 可 以 分 为 各 种 资源 。 资 源 是 一 个 有 趣 的 概念 实体 , 它 向 客户 端 公 
开 。 资 源 是 应 用 程序 对 象 数据库 记录 、 算 法 等 。 每 个 资源 都 使 用 URI(Universal Resource Identifier. 
统一 资源 标识 符 ) 得 到 一 个 唯一 的 地 址 。 所 有 资源 都 共享 统一 的 接口 ,以 便 在 客户 端 和 服务 器 端 之 间 传 
输 状 态 。 它 使 用 的 是 标准 的 HTTP 方 法 ,如 GET、PUT、POST 和 DELETE。 超 媒体 是 应 用 程序 状态 
的 引擎 ,资源 表示 通过 超 链 接 互 联 。 

另 一 个 重要 的 REST 原则 是 分 层 系统 ,也 就 是 说 ,无 法 了 解 与 之 交互 的 中 间 层 以 外 的 组 件 。 通 过 将 
系统 知识 限制 在 单个 层 ,可 以 限制 整个 系统 的 复杂 性 ,促进 了 底层 的 独立 性 。 

当 REST 架构 的 约束 条 件 作 为 一 个 整体 应 用 时 ,将 生成 一 个 可 以 扩展 到 大 量 客户 端的 应 用 程序 。 
它 还 降低 了 客户 端 和 服务 器 端 之 间 的 交互 延迟 。 统 一 界面 简化 了 整个 系统 架构 ,改进 了 子 系统 之 间 交 
互 的 可 见 性 ,REST 简化 了 客户 端 和 服务 器 端的 实现 。 


1.4.2 实现 


了 解 了 什么 是 REST, 下 面 介绍 RESTful 的 具体 实现 。 本 节 主 要 描述 RESTful Web 服务 与 RPC 
样式 的 Web 服务 的 区 别 .RESTful Web 服务 的 Java 框架 ,构建 RESTful Web 服务 的 多 层 架 构 。 

1. RESTful Web 服务 与 RPC 样式 的 Web 服务 的 区 别 

使 用 RPC 样式 构建 基于 SOAP 的 应 用 ,成 为 实现 面向 服务 架构 的 最 常用 方法 。RPC 样式 的 Web 
客户 端 将 一 个 装 满 数据 的 数据 包 ( 包 括 方法 和 参数 信息 ) 通 过 HTTP 发 送 到 服务 器 端 。 服 务 器 端 打开 
数据 包 , 使 用 传人 参数 执行 指定 的 方法 ,将 结果 打包 作为 响应 发 回 客户 端 ,客户 端 收 到 响应 并 打开 数据 
包 , 每 个 对 象 都 有 自己 独特 的 方法 以 及 仅 公开 一 个 URI 的 RPC 样式 Web 服务 ,URI 表示 单个 端点 。 
这 种 方法 忽略 HTTP 的 大 部 分 特性 且 仅 支持 POST 方法 。 

由 于 轻 量 级 以 及 通过 HTTP 直接 传输 数据 的 特性 ,Web 服务 的 RESTful 方法 已 经 成 为 最 常见 的 
替代 方法 。 可 以 使 用 各 种 语言 (如 Java, Perl, Ruby, Python, PHP, JavaScript 和 Ajax) 实现 客户 端 。 
RESTful Web 服务 通常 可 以 通过 自动 客户 端 或 代表 用 户 的 应 用 程序 访问 。 但 是 ,这 种 服务 的 简便 性 让 
用 户 能 够 与 之 直接 交互 ,使 用 它们 的 Web 浏览 器 构建 一 个 GET URL 并 读 取 返回 的 内 容 。 

在 RESTful 样式 的 Web 服务 中 ,每 个 资源 都 有 一 个 地 址 。 资 源 本 身 都 是 方法 调用 的 目标 ,方法 列 
表 对 于 所 有 资源 都 是 标准 方法 ,包括 HTTP 的 GET、POST、PUT 和 DELETE. 还 可 能 包括 HEADER 
和 OPTIONS。 
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在 RPC 样式 的 架构 中 ,关注 点 在 于 方法 ; 而 在 RESTful 样式 的 架构 中 ,关注 点 在 于 资源 , 它 将 使 用 
标准 方法 检索 并 操作 信息 字段 (使 用 表示 的 形式 ) ,资源 表示 使 用 超 链接 形式 。 

Leonard Richardson 和 Sam Ruby 在 他 们 的 著作 REST ful Web Services 中 引入 了 术语 REST- 
RPC 混合 架构 。REST-RPC 混合 Web 服务 不 使 用 打包 封装 方法 .参数 和 数据 ,而 是 直接 通过 HTTP 
传输 数据 ,这 与 RESTful 样式 的 Web 服务 是 类 似 的 。 但 是 它 不 使 用 标准 的 HTTP 方法 操作 资源 , 它 在 
HTTP 请 求 的 URI 部 分 存储 方法 信息 。 知 名 的 Web 服务 (如 Yahoo 的 Flickr API 和 Delicious API) 
都 使 用 这 种 混合 架构 。 

2. RESTful Web 服务 的 Java 框架 

有 两 个 Java 框架 可 以 帮助 构建 RESTful Web 服务 。Erome Louvel 和 Dave Pawson 开发 的 
Restlet 是 轻 量 级 的 。 它 实现 针对 各 种 RESTful 系统 的 资源 表示、 连接 器 和 媒体 类 型 之 类 的 概念 ,包括 
Web 服务 。 在 Restlet 框架 中 ,客户 端 和 服务 器 端 都 是 组 件 。 组 件 通 过 连接 器 互相 通信 。 该 框架 最 重 
要 的 类 是 抽象 类 Uniform 及 其 具体 的 子 类 Restlet. Uniform 的 子 类 是 专用 类 ,如 Application, Filter, 
Finder „Router 和 Route。 这 些 子 类 能 够 一 起 处 理 验证 .过 滤 安全、 数据 转换 以 及 将 传人 请 求 路 由 到 相 
应 资源 等 操作 。Resource 类 生成 客户 端的 表示 形式 。 

JSR-311 是 Sun Microsystems 的 规范 ,可 以 为 开发 RESTful Web 服务 定义 一 组 Java API, Jersey 
是 对 JSR-311 的 参考 实现 。JSR-311 提供 一 组 注解 ,相关 类 和 接口 都 可 以 用 来 将 Java 对 象 作 为 Web Vt 
源 展 示 。 该 规范 假定 HTTP 是 底层 网 络 协议 , 它 使 用 注释 提供 URI 和 相应 资源 类 之 间 的 清晰 映射 ,以 
及 HTTP 方法 与 Java 对 象 方法 之 间 的 映射 。API 支持 广泛 的 HTTP 实体 内 容 类 型 ,包括 HTML, 
XML JSON, GIF fill JPG 等 。 它 还 将 提供 所 需 的 插件 功能 ,以 允许 使 用 标准 方法 ,通过 应 用 程序 添加 其 
他 类 型 。 

3. 构建 RESTful Web 服务 的 多 层 架 构 

RESTful Web 服务 和 动态 Web 应 用 程序 在 许多 方面 都 是 类 似 的 。 有 时 它们 提供 相同 或 非常 类 
似 的 数据 和 函数 ,尽管 客户 端的 种 类 不 同 。 例 如 ,在 线 电 子 商务 分 类 网 站 为 用 户 提 供 一 个 浏览 器 界 
面 ,用 于 搜索 、 查 看 和 订购 产品 。 如 果 为 公司 ,零售 商 甚至 个 人 能 够 自动 订购 产品 提供 Web 服务 , 它 
将 非常 有 用 。 与 大 部 分 动态 Web 应 用 程序 一 样 . Web 服务 可 以 从 多 层 架 构 的 关注 点 分 离 中 受益 。 
业务 逻辑 和 数据 可 以 由 自动 客户 端 和 图 形 用 户 界面 客户 端 共 享 ,不 同 点 在 于 客户 端的 本 质 和 中 间 的 
表示 层 。 此 外 ,从 数据 访问 中 分 离 业务 逻辑 可 实现 数据 库 独 立 性 ,并 为 各 种 类 型 的 数据 存储 提供 插 
件 能 力 。 

图 1-8 是 自动 化 客户 端 架构 ,包括 Java 和 各 种 语言 编写 的 脚本 .这 些 语言 包括 Perl, Ruby, PHP, 
Python 或 命令 行 工具 (如 Curl)。 在 浏览 器 中 运行 且 作 为 RESTful Web 服务 消费 者 运行 的 Ajax, 
Flash,JavaFX,GWT .博客 和 WiKi 都 属于 此 列 .因为 它们 都 代表 用 户 以 自动 化 方式 运行 。 自 动 化 Web 
服务 客户 端 在 Web 层 向 资源 请 求 处 理 程序 发 送 HTTP 响应 。 客 户 端 的 无 状态 请 求 在 头 部 包含 方法 信 
息 , 即 POST.GET,PUT 和 DELETE, 这 又 将 映射 到 资源 请 求 处 理 程序 中 的 相应 操作 。 每 个 请 求 都 包 
含 所 有 必需 的 信息 ,包括 资源 请 求 处 理 程序 用 来 处 理 请 求 的 依据 。 

从 Web 服务 客户 端 收 到 请 求 之 后 ,资源 请 求 处 理 程 序 从 业务 逻辑 层 请 求 服务 。 资 源 请 求 处 理 程序 
确定 所 有 概念 性 的 实体 ,系统 将 这 些 实体 作为 资源 公开 .并 为 每 个 资源 分 配 唯 一 的 URI。 但 是 ,概念 性 
的 实体 在 该 层 是 不 存在 的 ,它们 存在 于 业务 逻辑 层 。 可 以 使 用 Jersey 或 其 他 框架 (如 Restlet) 实 现 资源 
请 求 处 理 程序 , 它 应 该 是 轻 量 级 的 .将 大 量 工作 委托 给 业务 逻辑 层 。 

Ajax 和 RESTful Web 服务 本 质 上 是 互 为 补充 的 。 它 们 都 可 以 利用 大 量 Web 技术 和 标准 ,例如 
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HTML JavaScript, 浏览 器 对 象 .XML/JSON 和 HTTP。 当 然 也 不 需要 购买 .安装 或 配置 任何 主要 组 
件 支持 Ajax 前 端 和 RESTful Web 服务 之 间 的 交互 。RESTful Web 服务 为 Ajax 提供 了 非常 简单 的 
API, 以 处 理 服务 器 端 资源 之 间 的 交互 。 

图 1-8 中 的 浏览 器 客户 端 作为 图 形 用 户 界面 的 前 端 ,使 用 表示 层 中 的 浏览 器 请 求 处 理 程序 生成 
HTML 提供 显示 功能 。 浏 览 嚣 请求 处 理 程序 可 以 使 用 模型 -视图 -控制 器 模型 (Struts、JSF 或 Spring 都 
是 Java 的 示例 )。 它 从 浏览 器 接收 请 求 ,从 业务 逻辑 层 请 求 服务 ,生成 表示 并 对 浏览 器 做 出 响应 。 表 示 
供用 户 在 浏览 器 中 显示 使 用 。 表 示 不 仅 包含 内 容 ,还 包含 显示 的 属性 ,如 HTML 和 CSSCCascading 
Style Sheets ,串联 样式 表 ) 。 
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图 1-8 自动 化 客户 端 架构 


业务 规则 可 以 集中 到 业务 逻辑 层 ,该 层 充当 表示 层 和 数据 访问 层 之 间 的 数据 交换 中 间 层 。 数 据 以 
域 对 象 或 值 对 象 的 形式 提供 给 表示 层 。 从 业务 逻辑 层 中 解 耦 浏览 器 请 求 处 理 程序 和 资源 请 求 处 理 程序 
有 助 于 促进 代码 重用 ,并 能 实现 灵活 和 可 扩展 的 架构 。 此 外 ,由 于 将 来 可 以 使 用 新 的 REST 和 模型 - 视 
图 -控制 器 框架 ,因此 实现 它们 会 变 得 更 加 容易 ,无须 重 写 业 务 逻 辑 层 。 

数据 访问 层 提供 与 数据 存储 层 的 交互 .可 以 使 用 DAO 设计 模式 或 者 对 象 -关系 映射 解决 方案 (如 
Hibernate、.OJB 或 iBatis/Mybatis) 实 现 。 作 为 替代 方案 ,业务 逻辑 层 和 数据 访问 层 中 的 组 件 可 以 实现 
为 EJB 组 件 ,并 取得 EJB 容器 的 支持 ,该 容器 可 以 为 组 件 生 命 周 期 提供 便利 ,管理 持久 性 、 事 务 和 资源 
配置 。 但 是 ,这 需要 一 个 遵从 Java EE 的 应 用 服务 器 (如 JBoss) ,并 且 可 能 无 法 处 理 Tomcat。 该 层 的 作 
用 在 于 针对 不 同 的 数据 存储 技术 ,从 业务 逻辑 层 中 分 离 数据 访问 代码 。 数 据 访问 层 可 以 作为 连接 其 他 
系统 的 集成 点 ,还 可 以 成 为 其 他 Web 服务 的 客户 端 。 

数据 存储 层 包括 数据 库 `LDAP 服务 器 、 文 件 系 统 和 遗留 系统 。 使 用 该 架构 ,可 以 看 到 RESTful 
Web 服务 的 力量 , 它 可 以 灵活 地 成 为 任何 企业 数据 存储 的 统一 API, 从 而 向 以 用 户 为 中 心 的 Web 应 用 
程序 公开 垂直 数据 ,并 自动 化 批量 报告 脚本 。 

REST 描述 了 一 个 架构 样式 的 互联 系统 (如 Web 应 用 程序 )。REST 约束 条 件 作为 一 个 整体 应 用 
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时 ,将 生成 一 个 可 扩展 ,简单 有 效 、 安 全 和 可 靠 的 架构 。 由 于 具有 简便 、 轻 量 级 以 及 通过 HTTP 直接 传 
输 数 据 的 特性 ,RESTful Web 服务 成 为 基于 SOAP 服务 的 一 个 最 有 前 途 的 替代 方案 。 用 于 Web 服务 
和 动态 Web 应 用 程序 的 多 层 架 构 , 可 以 实现 重用 性 、 简 单 性 、 扩 展 性 和 组 件 响 应 性 的 清晰 分 离 。 开 发 人 
员 可 以 轻松 使 用 Ajax 和 RESTful Web 服务 一 起 创建 丰富 的 界面 。 

RESTful 的 关键 是 定义 可 表示 流程 元 素 /资源 的 对 象 。 在 REST 中 ,每 一 个 对 象 都 是 通过 URL 来 
表示 的 ,对 象 用 户 负 责 将 状态 信息 打包 进 每 一 条 消息 内 ,以 便 对 象 的 处 理 总 是 无 状态 的 。RESTful 是 组 
合 管理 及 流程 绑 定 ,适应 企业 等 级 的 发 现 、 绑 定 的 灵活 性 和 复杂 性 。 

OCF 使 用 RAML(RESTful API Modeling Language, RESTful API 建 模 语言 ) 描 述 ,RAML 是 对 
RESTful API 的 一 种 简单 和 直接 的 描述 。 它 是 一 种 让 人 们 易于 阅读 ,并 且 能 让 机 器 对 特定 的 文档 解析 
的 语言 。RAML 基于 YAML(Yet Another Markup Language, 又 一 种 标识 语言 ) ,能 帮助 设计 RESTful 
API 和 鼓励 对 API 的 发 据 和 重用 .依靠 标准 和 最 佳 实践 ,从 而 编写 更 高 质量 的 API。 通 过 RAML 定 
XC ,机 器 能 够 看 得 懂 , 所 以 可 以 衍生 出 一 些 附加 的 功能 服务 ,例如 ,解析 并 自动 生成 对 应 的 客户 端 调用 代 
码 、 服 务 器 端 代码 结构 及 API 的 说 明文 档 。 

RAML 本 质 上 可 以 理解 为 一 种 文档 的 书写 格式 ,这 种 格式 是 特别 针对 API 的 ,就 像 Markdown 是 
针对 HTML 的 一 样 。 并 且 ,RAML 也 同样 具备 了 像 Markdown 那样 的 可 读 性 ,即使 看 RAML 源码 也 
能 很 快 明白 其 意图 。 另 外 ,基于 RAML 语言 ,有 不 少 辅助 API 开发 的 工具 ,如 RAML2HTML 和 API- 
Console ,它们 都 可 以 将 RAML 源 文件 转换 成 精美 的 文档 页 面 ,其 中 ,RAML2HTML 转换 结果 是 静态 
的 ,API-Console 则 可 以 产生 可 直接 交互 的 API 文档 页 面 ,类 似 1.6 节 介 绍 的 Swagger, 


1.5 Swagger 


Swagger 与 RAML 相 比 ,RAML 解决 的 是 设计 阶段 的 问题 ,而 Swagger 则 是 侧重 解决 现 有 API 的 
文档 问题 ,它们 最 大 的 不 同 是 RAML 需要 单独 维护 一 套 文档 ,而 Swagger 则 是 通过 一 套 反射 机 制 从 代 
码 中 生成 文档 ,并 且 借 助 Ajax 直接 在 文档 中 对 API 进行 交互 。 因 为 代码 与 文档 是 捆绑 的 ,所 以 在 迭代 
代码 的 时 候 , 就 能 方便 地 将 文档 也 更 新 了 .不 会 出 现 随 着 项 目 推移 代码 与 文档 不 匹配 的 问题 ,另外 ， 
Swagger 是 基于 JSON 进行 文档 定义 的 。 

Swagger API 框架 用 于 管理 项 目 中 的 API 接口 ,是 当前 流行 的 API 接口 管理 工具 。Swagger 是 一 
个 开源 框架 (Web 框架 ) ,功能 强大 ,UI 界面 友好 ,支持 在 线 测试 。 

Swagger 的 目标 是 对 REST API 定义 一 个 标准 的 与 语言 无 关 的 接口 ,可 让 人 和 计算 机 无 须 访问 源 
码 文档 或 网 络 流量 监测 ,就 可 以 发 现 和 理解 服务 。 通 过 Swagger 进行 正确 定义 ,用 户 可 以 理解 远程 服 
务 , 并 使 用 最 少 实现 逻辑 与 远程 服务 进行 交互 。 与 底层 编程 所 实现 的 接口 类 似 ,Swagger 消除 了 调用 服 
务 时 可 能 存在 的 猜测 。 

Swagger 是 一 组 开源 项 目 , 主 要 项 目 如 下 。 

Swagger-Tools: 提供 各 种 与 Swagger 进行 集成 和 交互 的 工具 。 例 如 ,模式 检验 .Swagger 1. 2 版 本 
的 文档 转换 成 Swagger 2.0 版 本 的 文档 等 功能 。 

Swagger-Core: 用 于 Java/Scala 的 Swagger 实现 。 与 JAX-RS(Jersey、Resteasy、CXF)、Servlets 和 
Play 框架 进行 集成 。 
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Swagger-JS: 用 于 JavaScript 的 Swagger 实现 。 

Swagger-Node-Express: Swagger 模块 ,用 于 Node. js 的 Express Web 应 用 框架 。 

Swagger-UI: 一 个 不 依赖 HTML JavaScript 和 CSS 的 集合 ,可 以 为 Swagger 兼容 API 动态 生成 
优雅 文 档 。 

Swagger-Codegen: 一 个 模板 驱动 引擎 ,通过 分 析 用 户 Swagger 资源 声明 ,以 各 种 语言 生成 客户 端 
代码 。 

Swagger-Editor: 可 让 使 用 者 在 浏览 器 里 以 YAML 格式 编辑 Swagger API 规范 ,并 实时 预览 文档 ; 
可 以 生成 有 效 的 Swagger JSON 描述 ,并 用 于 所 有 Swagger 工具 (代码 生成 .文档 等 ) 中 。 
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CHAPTER 2 








物 联网 即 万 物 互联 ,就 是 要 将 所 有 的 人 和 设备 联系 在 一 起 ,根据 目前 的 互联 网 应 用 ,发 挥 更 加 多 样 
的 功能 ,从 而 丰富 我 们 的 生活 。 因 而 , 物 联网 的 产 出 之 一 便 是 智能 生活 ,在 不 久 的 将 来 ,与 人 们 的 生活 息 
息 相 关 的 各 种 设备 都 通过 网 络 互联 实现 联动 ,为 人 们 提供 更 加 丰富 的 生活 情景 ,如 智能 家 居 AI I 
室 、 车 联网 以 及 各 种 智能 硬件 等 应 用 。 

在 物 联网 中 ,将 会 有 数 以 亿 计 的 设备 , 物 联网 无 法 像 互 联网 一 样 将 所 有 的 设备 都 注册 在 一 个 控制 中 
心 ,但 交互 最 多 的 还 是 网 络 互联 的 邻近 设备 。 因 此 ,业界 迫切 需要 有 一 个 服务 框架 ,能 自动 识别 出 邻近 
物 联网 中 存在 的 设备 和 服务 ,而 且 随 着 设备 暴露 出 越 来 越 多 的 连接 和 控制 接口 ,安全 问题 也 日 益 突出 。 

如 果 将 不 同 生活 场景 看 作 一 个 邻近 的 物 联网 络 ,那么 ,今后 人 们 生活 的 情景 有 可 能 如 图 2-1 所 示 。 


物 联网 近 端 网 络 1 物 联网 近 端 网 络 2 
(家 庭 ) (办 公 室 ) 








物 联网 近 端 网 络 3 物 联网 近 端 网 络 4 
(车 载 ) (个 人 移动 网 络 ) 





图 2-1 物 联 网 的 应 用 场景 


在 同一 个 物 联网 络 中 的 智能 设备 能 自动 发 现 其 他 设备 和 服务 的 存在 .并 与 之 进行 端 对 端的 通信 。 
对 于 那些 需要 通过 网 络 地 址 转换 的 设备 .可 以 通过 云端 的 发 现 服务 去 寻找 自己 感 兴趣 的 设备 ,当然 这 些 
云端 的 服务 也 可 以 让 不 同 邻 近 区 域 的 设备 实现 通信 , 除 此 之 外 .云端 的 服务 还 可 以 为 整个 物 联 网 提供 某 
些 特定 的 功能 。 

从 图 2-1 可 以 看 出 ,在 物 联网 中 .邻近 物 联 网 设备 之 间 的 相互 交互 是 实现 物 联 网 丰富 功能 的 关键 所 
在 。 整 个 物 联网 最 关键 的 便 是 设备 广播 和 发 现 \ 网 络 的 动态 移动 管理 .安全 性 和 隐私 .不 同 操作 系统 的 
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交互 和 拓展 性 。 因 此 ,本 章 将 详细 介绍 目前 全 球 最 受 关注 的 开源 项 目 一 一 OCF 技术 , 它 是 目前 最 主要 
的 物 联网 框架 之 一 。 


2.1 OCF 术语 和 定义 


OCF 核心 资源 : 在 OCF 规范 中 定义 的 OCF 资源 。 

配置 源 : 在 云 平 台 或 服务 网 络 的 一 个 实体 或 一 个 本 地 只 读 文件 .包括 提供 与 OCF 设备 的 相关 配置 
信息 。 

实体 : 物质 世界 的 一 个 要 素 , 由 OCF 设备 实现 。 

观察 : 该 行为 通过 发 送 检索 请 求 来 监测 OCF 资源 ,检索 请 求 由 托管 OCF 资源 的 OCF 服务 器 端 组 
存 , 并 且 每 次 OCF 资源 发 生 改变 时 ,检索 请 求 都 会 被 重新 处 理 。 

OCF 客户 端 : 在 OCF 服务 器 端 连接 OCF 资源 的 逻辑 实体 。 

OCF 集合 : 包括 零 或 多 个 OCF 链接 的 OCF 资源 。 

OCF 设备 : 呈现 一 个 或 多 个 OCF 角色 (OCF 客户 端 或 OCF 服务 器 端 ) 的 逻辑 实体 。 注 意 ,一 个 物 
理 平 台 上 可 以 有 多 个 OCF 设备 。 

OCF 功能 : 在 任何 OCF 设备 中 包含 的 基础 或 核心 功能 。 

OCF 框架 : 一 套 在 规范 中 定义 通用 的 功能 和 相互 作用 ,能 够 实现 众多 网 络 设备 之 间 的 互 操 作 性 , 包 
括 loT, 

OCF 基础 设施 网 关 : OCF 平台 ,能 够 保证 OCF 设备 之 间 的 互 操作 性 。 

OCF 平台: 包含 一 个 或 多 个 OCF 设备 的 物理 设备 。 

OCF 链接 : 在 IETF RFC 5988 中 规定 的 拓展 类 型 网 站 链接 。 

OCF 资源 : 代表 人 工 产品 ,由 OCF 框架 建 模 和 呈现 。 

OCF 资源 接口 : 对 请 求 OCF 资源 的 资格 允许 认证 。 

OCF 资源 属性 : 是 资源 的 重要 方面 或 概念 ,包括 OCF 资源 呈现 的 元 数据 。 

OCF 资源 类 型 : 唯一 的 命名 定义 了 OCF 资源 属性 的 类 以 及 该 类 支持 的 接口 。 每 一 个 资源 都 有 一 
个 rt 属性 ,该 属性 值 是 资源 类 型 的 唯一 名 称 。 

OCF 服务 器 端 : 提供 资源 状态 信息 和 促进 其 资源 的 远程 交互 功能 的 逻辑 实体 ,可 以 实现 服务 器 端 
将 非 设 备 资源 暴露 给 客户 端 。 

JE OCF 设备 : 不 遵守 OCF 规范 的 设备 。 

通知 : 使 OCF 客户 端 发 现 OCF 资源 状态 变化 的 机 制 。 

部 分 更 新 : 资源 更 新 请 求 。 该 资源 中 包括 属性 的 一 个 子 集 , 子 集中 的 属性 对 应 用 于 资源 类 型 的 接 
口 是 可 见 的 。 

远程 接 人 端点 客户 端 : 支持 XMPP(Extensible Messaging and Presence Protocol, 可 扩展 消息 处 理 
现场 协议 ) 功 能 的 OCF 客户 端 。 

远程 接 入 端点 服务 器 端 : 支持 XMPP 的 OCF 服务 器 端 ,并 且 可 以 将 其 资源 发 布 给 XMPP 服务 器 
端 ,从 而 可 以 实现 远程 寻 址 及 接 入。 

资源 目录 : 掌握 其 他 OCF 服务 器 端 上 资源 描述 的 OCF 设备 , 且 人 允许 其 查找 这 些 资源 。 该 功能 的 
使 用 可 以 通过 服务 器 端 睡眠 /服务 器 端 不 监听 响应 多 播 请 求 的 方式 来 实现 。 

场景 : 场景 值 中 所 列 的 值 。 一 个 场景 是 一 组 资源 的 一 个 规定 设置 .其 中 每 一 个 资源 都 有 对 于 该 属 
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性 预先 设置 的 值 .这 些 值 可 以 进行 修改 。 

场景 集合 : 包含 可 能 的 场景 值 列表 以 及 当前 场景 值 的 OCF 资源 。 该 资源 是 一 个 有 附加 数据 的 集 
合资 源 ,场景 资源 的 成 员 值 是 场景 成 员 。 

场景 值 : 呈现 OCF 资源 可 能 状态 的 场景 列表 。 

场景 成 员 : 一 种 OCF 资源 ,包含 场景 值 对 应 资源 的 属性 值 映 射 。 

规则 : 该 OCF 资源 包含 一 个 条 件 , 当 该 条 件 为 真 时 则 会 在 OCF 服务 器 端 启动 一 个 脚本 。 

规则 条 件 : 是 一 个 表达 式 ,描述 如 何 对 资源 特性 的 一 个 值 评估 。 规 则 条 件 是 以 扩展 巴 科 斯 范式 的 
格式 表达 的 ,并 且 使 用 特定 服务 器 端 资源 属性 的 引用 。 

规则 成 员 : OCF 资源 ,其 中 包含 当 规则 条 件 为 真 时 设置 的 资源 属性 值 。 

脚本 : 当 规则 条 件 为 真 时 被 执行 的 规则 成 员 。 

默认 接口 : 当 在 一 个 请 求 中 省 略 了 一 个 接口 时 ,使 用 该 接口 产生 响应 。 

参数 : 如 果 资 源 被 一 个 链接 的 目标 URI 所 引用 , 则 提供 关于 该 资源 的 元 数据 。 


2.2 OCF 技术 简介 


本 节 主 要 介绍 OCF 系统 的 架构 .OCF 框架 功能 和 OCF 角色 的 示例 场景 。 

1. OCF 的 系统 架构 

OCF 的 宗旨 : 定义 一 个 通用 的 通信 框架 ,实现 不 同 操作 系统 .不同 设备 之 间 的 互联 互通 。 它 包含 的 
核心 功能 主要 有 标识 和 寻 址 ,设备 和 资源 发 现 、 资 源 模型 CRUDN (Create/Retrieve/Update/Delete/ 
Notify, 创 建 /检索 /更 新 /删除 /通知 ?操作 、 报 文 传输 .设备 管理 和 安全 等 。 

OCF 采用 资源 表示 方法 ,运用 RESTful 的 操作 接口 来 使 用 资源 .所 有 OCF 设备 由 包含 的 资源 及 相 
应 的 URI 表 示 。 每 个 提供 资源 表示 的 OCF 设备 都 能 充当 服务 器 端的 角色 。 相 应 地 ,主动 发 起 资源 操 
作 请 求 的 设备 充当 客户 端的 角色 。 资 源 操作 包括 创建 、 检 索 ,更 新 .删除 和 通知 。 

OCF 的 系统 架构 实现 了 物 联网 的 物理 设备 或 应 用 之 间 基 于 资源 的 交互 。OCF 的 系统 架构 充分 利 
用 现存 的 行业 标准 和 技术 .并且 提供 了 建立 连接 (无 线 或 有 线 ) 的 解决 办 法 ,为 各 种 场景 .操作 系统 提供 
管理 设备 之 间 的 信息 流动 。 

OCF 的 系统 架构 提供 了 如 下 可 能 : 多 个 细 分 市 场 (消费 者 ,企业 、 工 业 、 汽 车 和 医疗 等 ) 的 通信 和 互 
操作 框架 .操作 系统 .平台 、 通 信 方 式 . 传 输 和 使 用 情况 ; 一 种 描述 环境 促成 信息 和 语义 互 操作 的 通用 、 
一 致 的 模型 ; 用 于 发 现 和 连接 的 通用 通信 协议 ; 通用 的 安全 和 鉴定 机 制 ; 创新 和 产品 差异 化 的 机 会 ; 
表明 不 同 设备 能 力 可 拓展 的 解决 方案 ,适用 于 智能 设备 、 最 小 连接 以 及 可 穿戴 设备 。 

OCF 的 系统 架构 基于 面向 资源 的 设计 原则 ,在 OCF 的 系统 架构 中 物理 世界 的 实体 ,如 温度 传 感 
器 .电灯 或 电器 被 呈现 为 资源 。 和 一 个 实体 的 相互 作用 是 通过 其 资源 表示 实现 的 ,使 用 遵循 表述 性 状态 
转移 架构 风格 的 操作 ,如 RESTful 交互 。OCF 的 系统 架构 定义 了 OCF 框架 整体 结构 为 一 个 信息 系统 
以 及 构成 OCF 的 实体 间 的 交互 ; 实体 呈现 为 OCF 资源 ,携带 着 它们 独特 的 标识 符 以 及 支持 OCF 资源 
的 RESTful 操作 接口 。 

每 个 RESTful 操作 都 有 一 个 操作 的 发 起 者 (客户 端 ) 以 及 一 个 操作 的 应 答 者 (服务 器 端 ) 。 在 OCF 
框架 中 ,客户 端 和 服务 器 端 概念 是 由 OCF 角色 实现 的 。 任 何 OCF 设备 都 可 以 作为 OCF 客户 端 或 服务 
器 端 , 在 OCF 设备 上 初始 化 RESTful 操作 。 同 样 ,任何 将 实体 呈现 为 OCF 资源 的 OCF 设备 ,也 可 以 
作为 OCF 服务 器 端 使 用 。 遵 循 REST 架构 风格 ,每 个 在 OCF 的 RESTful 操作 中 ,包括 所 有 能 够 理解 
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交互 内 容 的 必要 信息 ,并 且 用 一 小 部 分 通用 操作 就 可 以 驱动 ,如 CRUDN 操作 ,这 些 也 包括 了 对 OCF 资 
源 的 表示 。 图 2-2 描述 了 OCF 的 系统 架构 。 
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图 2-2 OCF 的 系统 架构 


架构 概念 分 为 三 个 主要 方面 : 资源 模型 .RESTful 操作 和 抽象 化 。 

资源 模型 : 提供 了 逻辑 模型 所 需 的 抽象 和 概念 ,并 在 逻辑 上 操作 其 应 用 程序 及 环境 。 资 源 模型 和 
应 用 领域 无 关 , 如 智能 家 居 、 工 业 或 汽车 。 资 源 模型 定义 了 抽象 化 实体 的 OCF 资源 , 且 OCF 资源 表示 
映射 为 实体 的 状态 。 其 他 模型 概念 可 以 用 来 模拟 行为 模型 等 。 

RESTful 操作 : 一 般 的 操作 被 定义 为 用 RESTful 范例 来 模拟 协议 以 及 OCF 资源 的 交互 。 具 体 的 
通信 或 信息 传递 是 协议 抽象 的 一 部 分 ,并 且 OCF 资源 和 特定 协议 的 映射 将 在 本 书 中 讲述 。 

抽象 化 : 在 资源 模型 中 的 抽象 和 RESTful 操作 被 抽象 原 语 喘 射 到 具体 元 素 。 实 体 处 理 程序 用 于 喘 
射 到 OCF 资源 以 及 连接 抽象 原 语 ,这 些 抽 象 原 语 用 来 映射 逻辑 RESTful 操作 到 数据 连接 协议 或 技术 ， 
实体 处 理 程序 也 会 被 映射 到 不 是 本 地 OCF 支持 的 实体 。 

OCF 功能 结构 如 图 2-3 所 示 ,分 为 L2 连接 层 、 网 络 层 传输 层 、.OCF 框架 层 和 应 用 配置 层 。 
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L2 连接 层 : 建立 物理 层 和 数据 链 路 层 连接 (如 WiFi di 4). 

网 络 层 : 提供 OCF 设备 所 需要 的 数据 交换 网 络 功能 (如 互联 网 ) 。 

传输 层 : 提供 端 到 端的 传输 路 径 , 如 TCP .UDP 及 新 的 IETF 传输 协议 。 

OCF 框架 层 : 提供 IP 寻 址 资源 发 现 ,资源 操作 、 设 备 管理 和 安全 管理 等 核心 功能 。 

应 用 配置 层 : 提供 对 应 于 某 一 领域 的 数据 模型 及 功能 ,如 智能 家 居 和 车 联网 等 。 

当 两 个 OCF 设备 互相 交流 时 ,一 个 OCF 设备 的 每 个 功能 模块 和 另 一 个 OCF 设备 的 对 应 模块 以 
图 2-4 所 示 的 方式 进行 交互 。 
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2-4 OCF 交流 分 层 模型 


2. OCF 框架 层 功 能 

OCF 框架 层 由 提供 OCF 操作 核心 的 功能 组 成 ,主要 包括 如 下 几 点 。 

COD IP 寻 址 : 定义 标识 符 和 寻 址 能 力 。 

(2) 资源 发 现 : 定义 发 现 可 用 的 OCF 设备 和 OCF 资源 的 过 程 。 

(3) 资源 模型 : 根据 资源 表示 实体 的 能 力 , 并 且 定 义 操作 资源 的 机 制 。 

(4) 资源 操作 : 提供 用 于 OCF 客户 端 和 OCF 服务 器 端 之 间 互 动 的 通用 方案 。 消 息 是 提供 
RESTful 操作 的 具体 消息 传递 协议 ,如 CRUDN 操作 、CoAP 消息 和 传递 协议 。 

(5) 设备 管理 : 指明 管理 OCF 设备 能 力 的 原则 ,并且 包括 设备 配置 .初始 化 以 及 设备 监测 与 诊断 。 

(6) 安全 管理 : 包括 对 实体 的 安全 访问 所 需 的 身份 验证 .授权 和 访问 控制 机 制 。 

3. OCF 角色 的 示例 场景 

OCF 的 交互 定义 于 人 逻辑 实体 之 间 . 该 逻辑 实体 被 称 为 OCF 角色 。OCF 定义 了 三 种 角色 : OCF 客 
户 端 .OCF 服务 器 端 和 OCF 中 介 。 

图 2-5 说 明了 在 一 个 场景 中 OCF 角色 的 例子 .该 场景 是 一 个 智能 手机 给 恒温 器 发 请 求 消息 ,原始 
消息 通过 HTTP 发 送 , 但 是 在 传输 中 被 网 关 转 换 为 CoAP 请 求 消息 ,然后 再 传递 给 恒温 器 。 在 这 个 例 
子 中 ,智能 手机 承担 了 OCF 客户 端的 角色 ,网 关 承 担 了 OCF 中 介 和 角色, 恒温 器 承担 了 OCF 服务 器 端的 
角色 。 

如 果 连 接 非 OCF 生态 系统 ,如 图 2-6 所 示 ,监测 心率 传感器 (心率 监测 仪 ) 的 腕 表 设 备 ,该 传感器 由 
dE OCF 的 协议 实现 。 提 供 了 一 个 详细 的 逻辑 观点 。 
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图 2-5 OCF 角色 示意 图 2-6 OCF 结构 细节 


OCF 结构 细节 可 以 通过 许多 方法 实现 ,例如 使 用 带 有 实体 处 理 器 的 OCF 服务 器 端 , 该 处 理 器 直接 
连接 非 OCF 设备 ,如 图 2-7 所 示 。 





服务 器 端 ) 





图 2-7 连接 非 OCF 系统 的 OCF 服务 器 端 


启动 时 ,OCF 服务 器 端 运 行 实体 处 理 器 来 发 现 非 OCF 系统 (例如 心率 传感器 设备 ) ,并 且 为 每 个 发 
现 的 设备 或 功能 创建 资源 。 实 体 处 理 器 给 每 个 发 现 的 设备 或 功能 创建 资源 ,并 且 将 其 OCF 资源 绑 定 ， 
通过 OCF 服务 器 端 ,使 得 这 些 资源 可 被 发 现 。 

一 且 资 源 被 创建 并 且 可 发 现 ,之 后 显示 设备 可 以 发 现 这 些 资源 ,并 且 使 用 规范 中 描述 的 机 制 去 操作 
它们 。 对 OCF 服务 器 端 资源 的 请 求 会 被 实体 处 理 器 翻译 ,并 且 通 过 非 OCF 设备 支持 的 协议 传递 给 非 
OCF 设备 , 非 OCF 设备 返回 的 信息 会 被 映射 成 该 资源 相应 的 应 答 。 


2.3 OCF 标识 与 寻 址 


为 了 有 效 促进 OCF 架构 元 素 间 的 互动 ,需要 一 种 方法 去 标识 元 素 ,命名 元 素 以 及 对 这 些 元 素 寻 址 。 

对 于 OCF 系统 中 的 标识 符 , 应 该 唯一 地 表示 环境 或 域 中 的 元 素 。 环 境 、 域 根据 使 用 情况 或 者 应 用 
程序 决定 。 元 素 的 标识 符 在 其 生命 周期 应 该 是 不 可 变 的 ,并 且 在 该 环境 或 域 中 是 独一无二 的 。 

与 其 他 系统 一 样 ,OCF 地 址 是 用 来 定义 一 个 位 置 .访问 元 素 的 方法 ,以 便 与 其 进行 交互 ,地 址 在 环 
境 中 是 可 变 的 。 

名 字 是 用 来 分 辨 架构 中 的 元 素 , 名 字 在 该 元 素 生命 周期 中 可 以 改变 。 可 以 通过 已 知 其 他 的 一 个 或 
多 个 条 件 决定 另 一 个 名 字 或 地 址 (如 用 地 址 决定 名 字 或 名 字 决 定 地 址 ) 。 

在 多 个 环境 中 ,可 以 分 别 定义 每 个 方面 (如 一 个 环境 可 以 是 一 层 ) 。 所 以 ,地 址 可 以 是 寻 址 资源 的 
URL 以 及 连续 层 寻 址 的 IP 地 址 。 在 某 些 情 况 下 .这 两 种 资源 都 需要 。 例 如 ,对 一 个 特定 的 资源 呈现 做 
检索 操作 ,客户 端 需要 知道 目标 资源 的 地 址 以 及 暴露 该 资源 的 服务 器 地 址 。 

在 使 用 的 环境 或 者 域 中 ,名 字 或 地 址 可 以 被 用 作 标识 符 , 反 之 亦 然 。 例 如 ,URL 可 以 被 用 作 资 源 的 
标识 符 并 且 可 被 制定 为 URI。 

本 节 的 其 余部 分 从 资源 模型 和 它 所 支持 交互 的 角度 讨论 标识 符 、 地 址 以 及 命名 。 交 互 是 基于 
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RESTful 的 ,例如 ,对 资源 的 操作 、 传 输 协议 的 映射 ,可 以 使 用 CoAP 协议 和 HTTP 协议 。 

标识 符 应 该 在 环境 或 使 用 域内 是 唯一 的 。 目 前 有 许多 方案 可 以 产生 具有 所 需 属 性 的 标识 符 。 标 识 
符 是 特定 背景 的 , 即 在 该 环境 或 域 中 是 独一无二 的 。 标 识 符 背 景 还 可 以 是 独立 的 , 即 这 些 标识 符 在 所 有 
环境 和 域 中 都 是 独一无二 的 。 特 定 背 景 标识 符 可 以 被 定义 为 像 单调 枚 举 的 简单 方案 或 者 定义 为 重 载 的 
地 址 或 名 称 。 例 如 ,一 个 IP 地 址 可 以 是 一 个 在 智能 网 关 后 的 私人 域 汇总 的 标识 符 。 另 外 ,背景 独立 标 
识 符 需 要 更 强 的 方案 去 派生 全 局 独立 标识 符 , 例 如 UUIDC Universally Unique Identifier, 全 局 唯一 标识 
符 ) 中 的 任何 一 个 。 背 景 独立 标识 符 可 通过 域 的 分 层 来 生成 , 即 层次 的 根 由 一 个 UUID 来 定义 , 子 域 通 
过 连接 这 个 域内 特定 背景 标识 符 和 其 父 域 的 背景 独立 标识 符 来 产生 背景 独立 标识 符 。 

资源 可 以 使 用 URI 标识 ,如 果 该 URI 是 一 个 URL. 则 可 以 用 同一 个 URI 去 寻 址 该 资源 。 在 一 些 
情况 下 ,资源 需要 和 URI 不 一 样 的 标识 符 , 在 这 种 情况 下 ,资源 属性 的 值 是 标识 符 。 当 URI 是 URL 
的 格式 时 ,该 URI 可 用 来 寻 址 该 资源 。 一 个 OCF 的 URI 是 基于 在 IETF RFC 3986 中 定义 的 ,URI 
的 一 般 格式 为 < scheme >://< Authority >/< Path >? < Query >。 对 于 OCF. URI 的 格式 为 oic:// 
< Authority >/< Path >? < Query >。 

每 个 使 用 的 部 分 说 明 如 下 : URI 的 方案 是 “oic”。*“oic" 方 案 表 示 了 语义 ,在 OCF 规范 定义 中 使 用 。 
如 果 一 个 URI 的 *//” 前 面 的 部 分 省 略 , 那 么 就 默认 其 使 用 OCF 方案 。 

在 请 求 者 通过 网 络 发 送 消息 之 前 ,每 个 传输 绑 定 需要 指明 一 个 OCF 的 URI 是 如 何 转 换 为 传输 协 
议 的 URI。 在 接收 端 也 是 相似 的 ,在 切换 到 接收 者 的 资源 模型 层 之 前 ,每 个 传输 绑 定 需 要 指明 OCF 是 
如 何 从 一 个 传输 协议 URI 转换 为 OCF 的 URI。 

如 果 权 限 是 局 部 OCF 设备 ,那么 “oic" 被 用 于 权限 。 权 限 的 一 般 形式 为 < host >:< port >, 其 中 ， 
< host > 是 名 字 或 者 终端 网 络 地 址 ,< port > 是 网 络 端 口号 。< host > 提供 的 内 容 如 下 : 对 于 IP 网 络 ， 
€ host > 是 < authority > 的 主机 名 或 IP 地址 ; 对 于 非 IP 网 络 ,< host > 是 名 字 或 者 合适 的 标识 符 ; 如 果 
< authority > 是 支持 资源 的 OCF 设备 ,那么 关键 词 oic 可 能 会 用 于 < host >, 

路 径 必须 是 唯一 的 字符 串 ,是 唯一 在 该 OCF 服务 器 环境 中 标识 或 指定 的 一 个 资源 。 在 此 版 本 中 ， 
一 个 路 径 不 应 该 包括 非 ASCI 字符 或 NUL 字符 。 路 径 应 该 以 */”( 斜 线 ) 开 始 。 为 了 方便 人 们 阅读 ,路 
径 可 能 用 “/” 分 隔 。 在 OCF 环境 中 ,“/” 分 离 段 被 视 为 一 个 字符 串 , 直 接 引 用 资源 ( 即 扁平 结构 ) 而 不 是 
解析 为 一 个 层次 架构 。 在 该 OCF 服务 器 中 ,路 径 或 路 径 中 的 子 字符 串 会 通过 哈 希 算法 或 其 他 方案 来 进 
行 压缩 ,当然 要 假设 产生 的 引用 在 该 主机 环境 内 是 唯一 的 。 

一 旦 产生 路 径 , 该 资源 的 客户 端 或 者 URI 的 接收 方 会 使 用 该 路 径 为 不 透明 字符 串 , 并 且 无 法 解析 
其 结构 ,组织 或 者 语义 。 

一 个 查询 字符 串 应 该 包括 “< name >=< value >” 字 段 对 的 列表 ,每 对 由 ";" 分 隔 。 查 询 字 符 串 将 被 
映射 到 相关 协议 的 语法 ,用 于 消息 传递 ,如 CoAP。 

URI 的 产生 : URI 可 以 是 绝对 的 (完全 限定 ), 也 可 以 是 相对 的 。URI 可 以 由 创造 该 资源 的 OCF 
客户 端 直接 定义 ,这 样 的 URI 可 以 是 相对 的 或 者 是 绝对 的 。 一 个 相对 的 URI 应 该 是 相对 于 其 归属 的 
OCF 设备 。 另 外 ,URI 可 以 由 该 资源 的 OCF 服务 器 端 ,自动 根据 该 资源 预先 定义 的 公约 或 者 组 织 , 依 
据 一 个 接口 一 些 原则 ,不 同 的 根 或 基础 来 生成 。 

URI 的 使 用 : 引用 一 个 URI 的 绝对 路 径 被 认为 是 一 个 不 透明 字符 串 ,客户 端 无 法 通过 其 推断 出 任 
何 准确 的 或 隐藏 URI 的 结构 , 即 URI 仅仅 是 一 个 地 址 。 拥 有 资源 的 OCF 设备 将 每 个 资源 的 URI 看 作 
是 一 个 只 用 来 寻 址 该 资源 的 不 透明 字符 串 。 例 如 ,URI 的 */a” 和 */a/b” 认 为 是 明确 的 地 址 ,而 且 资源 b 
不 是 资源 a 的 子 资源 。 
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命名 空间 : 相对 的 URI 前缀 “/oic/” 被 保留 为 一 个 OCF 规范 中 定义 的 .用 于 命令 URI 的 空间 ,不 能 


用 于 非 OCF 定义 规范 中 的 URI。 





网 络 寻 址 : OCF 规范 中 使 用 IP 地 址 , 即 当 设备 使 用 IP 配置 的 接口 时 ,使 用 IP 地 址 。 当 该 装置 只 
有 其 对 等 端的 身份 信息 ,需要 相关 的 机 制 将 标识 符 映 射 到 相应 地 址 。 


2.4 OCF 数据 类 型 


表 2-1 包含 了 OCF 数据 类 型 的 定义 。 数 据 类 型 来 源 于 欧洲 计算 机 制造 联合 会 中 定义 的 JSON 值 。 
但 是 ,OCF 资源 可 以 重 载 JSON 定义 的 值 .来 指定 JSON 值 的 特定 子 集 。OCF 数据 类 型 可 以 用 于 特定 
的 用 途 ,例如 ,因为 特定 的 原因 改变 一 个 字符 串 的 长 度 。 


R2-1 OCF 数据 类 型 的 定义 















































命 ” 名 JSON fit 描 xk 

boolean 布尔 型 二 进 制 值 0,1 

Eo nm 一 个 以 空白 (例如 空格 ) 分 隔 的 .由 字符 串 编码 的 值 组 成 的 列表 。 在 BSV 中 值 的 
类 型 由 使 用 BSV 的 特性 来 描述 ,如 BSV 整数 

csv "n 一 个 以 逗号 分 隔 的 ,由 字符 串 编码 的 值 组 成 的 列表 。 在 CSV. 中 值 的 类 型 由 使 用 
CSV 的 特性 来 描述 ,如 CSV 整数 

date 字符 串 在 ISO 8601 中 定义 ,格式 是 [yyyy]-[mm]-[dd]Z 

字符 中 在 ISO 8601 中 定义 ,级 联 的 data 与 time, FFA data 与 time 中 间 用 T 分 隔 。 格 式 
是 [yyyy]-[mm]-[dd]TLhh]:[mm]:[ss]Z 

enum To 枚 举 类 型 

float 数值 有 符号 的 IEEE 754 单 精度 浮 点 值 

integer 数值 有 符号 的 32 位 整数 

JSON 对 象 /数组 JSON 元 素 ,可 以 是 欧洲 计算 机 制造 联合 会 定义 的 一 个 对 象 或 者 数列 表示 的 数 
据 。 这 个 JSON 对 象 或 者 数列 可 以 用 JSON 图 标 来 描述 

string 字符 串 字母 字符 串 , 不 可 以 超过 最 大 长 度 ( 即 64 FH) 

time 字符 串 在 ISO 8601 中 定义 但 被 UTC 限制 , 且 尾 部 加 Z。 格 式 是 [hh]:[mm]:[ss]Z 

URI 字符 串 用 于 标识 一 个 资源 的 字符 串 ,其 值 不 应 超过 最 大 长 度 ( 即 256 字 节 ) 

UUID 字符 串 一 个 根据 IETF RFC 4122 标识 符 的 格式 


EIN OCF 的 资源 模型 


CHAPTER 3 








3.1 基本 概念 


资源 模型 定义 了 一 些 概 念 和 机 制 ,这 些 概念 和 机 制 提供 了 OCF 生态 系统 中 设备 之 间 的 一 致 性 和 核 
心 互 操作 性 。 在 此 基础 上 ,资源 模型 的 概念 和 机 制 被 映射 到 传输 协议 上 ,使 得 两 个 设备 之 间 可 以 进行 通 
信 , 即 每 次 传输 都 提供 了 通信 协议 的 互 操作 性 。 因 此 ,资源 模型 允许 独立 于 传输 来 定义 互 操作 人 性。 

此 外 ,资源 模型 中 的 概念 支持 基本 设备 及 彼此 之 间 关 系 的 建 模 , 并 在 一 个 环境 中 捕获 互 操作 人 性 所 需 
的 语义 信息 。 通 过 这 种 方式 ,OCF 超越 了 简单 的 协议 互 操作 性 ,在 可 穿戴 设备 和 物 联网 生态 系统 中 ,可 
以 获取 真正 互 操作 性 所 需 的 丰富 语义 。 

在 OCF 资源 模型 中 ,基本 概念 有 实体 、 资 源 \ 统 一 资源 标识 符 、 资 源 类 型 .属性 、 表 示 、 接 口 、 集 合 和 
链接 。 此 外 ,通用 的 操作 有 创建 .检索 ,更 新 .删除 和 通知 ,也 就 是 CRUDN。 这 些 概念 和 操作 以 各 种 各 
样 的 方式 组 合 , 可 以 为 OCF 框架 的 各 种 应 用 场景 定义 所 需 的 语义 和 互 操作 。 

OCF 资源 模型 框架 中 ,在 一 个 给 定 应 用 中 的 软 硬 件 人 工 产 品 、 值 ,用例 和 上 下 文 被 称 为 一 个 实体 。 
当 一 个 实体 需要 可 视 化 、 交 互 或 者 被 操作 时 , 它 就 会 由 一 个 抽象 概念 表示 ,这 个 抽象 概念 称 为 资源 。 一 
个 资源 的 压缩 和 表示 是 一 个 实体 的 最 重要 部 分 .通过 使 用 URI 可 以 被 标识 、 寻 址 和 命名 。 

“属性 ?就 是 “ 键 值 对 ” ,表示 资源 的 主要 部 分 。 这 些 属 性 的 一 个 “快照 ?就 是 资源 的 “表示 ”.“ 表 示 ” 
是 一 个 特定 的 视图 ,上 且 可 应 用 于 该 视图 中 的 机 制 就 是 “接口 ”。 与 一 个 资源 进行 交互 是 由 * 请 求 ” 和 * 响 
应 "完成 的 ,其 中 就 包含 “表示 ”。 

一 个 资源 实例 源 于 一 个 资源 类 型 。 一 个 资源 和 男 一 个 资源 之 间 的 单 向 关系 被 定义 为 一 个 “ 链 ”。 一 
个 有 “属性 ”和 *“ 链 路 ”的 资源 就 是 一 个 “集合 ”。 

一 组 "属性 ”可 以 用 来 定义 一 个 资源 的 一 个 状态 。 通 过 使 用 合适 的 “表示 ”. 使 用 该 资源 的 响应 或 到 
该 资源 的 请 求 ,该 资源 的 状态 可 以 被 检索 或 更 新 。 

一 个 资源 (和 资源 类 型 ) 可 以 表示 ,并 用 于 暴露 一 种 能 力 。 通 过 与 该 资源 的 交互 可 以 训练 或 使 用 这 
种 能 力 。 这 样 的 能 力 可 以 用 于 定义 类 似 发 现 ,管理 和 广播 这 样 的 过 程 。 例 如 ,在 一 个 设备 上 发 现 资源 ” 
可 以 定义 为 一 个 特定 资源 表示 的 检索 .该 资源 的 属性 值 描述 或 者 引用 设备 上 的 资源 。 

具有 请 求 或 响应 的 表示 信息 可 以 “在 线 ” 传 输 , 这 可 以 通过 使 用 传输 协议 序列 化 或 者 封装 到 传输 协 
议 负 载 上 的 方式 ,具体 的 方法 由 请 求 或 响应 到 传输 协议 的 映射 规范 来 决定 。 

在 本 书 中 ,以 RAML 定义 标准 规范 。 同 时 .也 可 以 使 用 JSON 模式 。 有 关 OCF 规范 中 定义 的 资源 
类 型 ,将 在 第 9 和 10 章 中 介绍 。 





32 «|| OCF 技 术 原理 及 物 联网 程序 开发 指南 


3.2 OCF 资源 


一 个 资源 可 能 会 被 定义 为 一 种 或 多 种 资源 类 型 ,请 求实 例 化 /创建 一 个 资源 应 该 指明 定义 该 资源 的 
一 个 或 多 个 资源 类 型 。 一 个 资源 将 被 托管 在 一 个 设备 中 ,如 上 所 述 ,一 个 资源 应 该 有 一 个 URI, 该 URI 
可 以 在 创建 或 实例 化 资源 时 由 管理 机 构 分 配 , 也 可 以 通过 资源 类 型 的 规范 预定 义 , 如 图 3-1 所 示 。 
Lo EE URS UD 
"rt": "oic.r.foobar". 
"if": "oic.if.a", 届 性 


"value";"Foo value" 
) 





图 3-1 一 个 资源 例子 


核心 资源 是 OCF 规范 中 定义 的 .用 于 实现 功能 交互 (如 发 现 ,设备 管理 等 ) 的 资源 。 其 中 ,功能 交互 
在 第 6 章 中 定义 。 在 核心 资源 中 ,“/oic/res”“/oic/p” 和 *oic/d" 是 所 有 的 设备 上 都 应 该 支持 的 ; 同时 ， 
设备 可 能 根据 支持 的 交互 功能 ,支持 其 他 的 核心 功能 。 


3.3 资产 属性 


一 个 属性 描述 了 资源 所 暴露 的 一 个 方面 或 概念 ,包括 与 该 资源 相关 的 元 信息 。 一 个 属性 应 该 有 一 
个 名 称 ( 即 属性 名 ) 和 一 个 值 ( 即 属性 值 )。 属 性 是 以 键 值 对 的 形式 存在 ,“ 键 "就 是 属性 名 ,“ 值 ”就 是 属性 
值 , 键 值 对 就 类 似 于 < 属性 名 > 二 < 属性 值 >。 例 如 ,如 果 “ 温 度 ” 属 性 有 一 个 属性 名 “temp” 和 一 个 属性 值 
“30F”, 则 该 属性 就 表达 为 “temp 二 30F”。 属 性 的 特定 形式 是 由 编码 模式 决定 的 。 例 如 ,在 JSON 中 , 属 
性 表示 为 “ 键 ”: 值 (如 “temp”: 30)。 除 此 之 外 ,属性 的 定义 包括 以 下 内 容 。 

CD 值 类 型 : 定义 了 属性 值 可 能 采用 的 值 。 值 类 型 可 以 是 一 个 简单 数据 类 型 (如 string boolean 
等 ) ,如 上 文 所 定义 ,也 可 以 是 一 个 用 特定 模式 定义 的 复杂 数据 类 型 。 值 类 型 可 以 定义 值 规则 , 即 定义 一 
些 规则 ,属性 值 会 采用 这 些 规则 ,并 将 其 用 于 属性 值 中 。 这 些 规 则 可 以 定义 值 的 范围 .最 大 、 最 小 值 . 公 
式 、 枚 举 值 集合 、 阵 列 . 条 件 值 , 甚 至 是 对 其 他 属性 值 的 依赖 关系 。 这 些 规则 可 以 用 于 验证 属性 值 中 的 特 
定 值 ,并 且 标记 错误 。 

(2) 强制 性 : 指明 对 于 一 个 给 定 的 资源 类 型 ,该 属性 是 否 是 强制 的 。 

(3) 访问 模式 : 指明 该 属性 是 否 可 以 被 读 写 。 更 新 等 同 于 写 入 。“r” 表 示 读 ,“w” 表 示 写 ,二 者 都 是 
可 以 被 指定 的 ; 同时 , 写 操作 并 不 会 意味 着 就 会 自动 进行 读 操作 。 

一 个 属性 的 定义 可 能 包括 下 列 附 加 信息 ,这 些 项 可 以 提供 有 用 的 信息 。 

COD 属性 名 : 指明 一 个 属性 人 性 化 的 名 称 ,通常 不 会 在 线 发 送 。 

(2) 描述 : 一 个 描述 性 的 文本 ,定义 该 属性 的 目的 和 预期 的 使 用 。 

一 个 属性 可 能 被 用 在 一 个 URI 的 查询 部 分 ,作为 选择 一 个 特定 资源 的 标准 。 该 过 程 可 以 通过 将 属 
性 声明 为 查询 的 一 个 字段 来 完成 ( 即 < 属性 名 > 二 < 想 要 的 属性 值 >)。 在 OIC 1. 1 版 本 的 规范 中 ,查询 过 
滤器 中 只 允许 ASCI 字符 串 ,不 允许 NUL 字符 串 。 这 意味 着 ,只 有 使 用 ASCI 字符 的 属性 值 , 才 可 以 
在 查询 过 滤器 中 被 匹配 。 当 查询 中 声明 的 属性 与 目标 资源 的 完整 表示 中 对 应 的 属性 相 匹配 时 ,该 资源 
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就 被 选择 。 完 整 表示 目标 所 有 资源 类 型 的 属性 集合 ,是 这 个 集合 的 快照 。 如 果 在 查询 的 “过 滤 ? 字 段 声 
明了 一 个 属性 ,那么 ,声明 的 属性 就 会 与 接口 定义 表示 相 匹配 ,以 隔离 表示 的 特定 部 分 。 

通常 来 说 ,一 个 属性 只 有 在 与 其 相关 的 资源 内 才 是 有 意义 的 。 然 而 ,有 一 些 属性 可 能 被 所 有 的 资源 
支持 , 称 为 公共 属性 ,这 些 属性 在 资源 之 间 保 持 资源 完整 性 , 即 它们 的 * 键 一 值 ? 对 在 所 有 的 资源 中 的 含 
义 都 相同 。 下 面 介绍 公共 属性 的 字段 。 

公共 属性 可 以 在 所 有 资源 中 定义 。 以 下 几 种 属性 被 定义 为 公共 属性 : 资源 类 型 .资源 接口 ,名称 和 
资源 标识 。 

一 个 公共 属性 的 名 称 应 该 是 唯一 的 ,不 应 该 被 其 他 属性 使 用 。 当 定义 一 个 新 的 资源 类 型 时 ,如 果 是 
非 公 共 属 性 , 则 不 应 该 使 用 已 经 存在 的 公共 属性 名 称 ( 如 ”rt"“i”“p” 和 ”id")。 如 果 定 义 一 个 新 的 公共 
属性 ,应 该 确定 其 名 称 不 应 该 被 其 他 属性 所 使 用 。 一 个 新 公共 属性 名 称 的 唯一 性 ,可 以 通过 检查 所 有 已 
存在 .OCF 所 定义 的 资源 类 型 属性 来 核实 。 然 而 , 随 着 资源 类 型 的 增长 ,这 可 能 越 来 越 难 以 处 理 。 为 了 
阻止 未 来 出 现 这 样 的 名 称 冲突 ,OCF 为 公共 属性 保留 了 一 个 特定 的 名 称 空间 。 

潜在 的 方法 有 : 可 能 会 分 配 一 个 特定 的 前 级 (例如 “oic”) , 接 在 该 前 级 后 面 的 名 称 前 (如 *oic. psize”) 
仅 用 于 公共 属性 ; @ 包 含 一 个 或 两 个 字母 的 名 称 被 保留 用 于 公共 属性 ,其 他 属性 名 称 的 长 度 都 要 大 于 
两 个 字母 ; 四 公共 属性 可 能 嵌 套 在 特定 的 对 象 下 ,以 与 它们 自身 区 分 。 

所 有 资源 属性 总 结 如 下 。 

COD 资源 类 型 (“rt”) : 该 属性 用 于 声明 资源 类 型 。 由 于 一 个 资源 可 以 被 定义 多 个 资源 类 型 ,因此 ， 
资源 类 型 属性 值 可 以 用 于 声明 多 个 资源 类 型 。 例 如 ,rt”":[*oic. wk. d". “oic. d. airConditioner” ] XH, 
包含 该 属性 的 资源 被 定义 为 "oic. wk, d" S" oic. d. airConditioner” 资 源 类 型 。 

(2) 接口 (“if”): 该 属性 声明 了 资源 支持 的 接口 。 接 口 属性 值 可 以 有 多 个 , 列 出 资源 支持 的 所 有 
接口 。 

(D 名 称 (“*n”): 该 属性 声明 了 分 配给 资源 * 人 类 可 读 ” 的 名 称 。 

(4) 资源 标识 符 (“id”) : 对 于 一 个 资源 的 特定 实例 ,该 属性 值 是 唯一 的 实例 标识 符 ( 在 整个 主机 服 
务 器 的 范围 内 唯一 ) ,该 标识 符 的 编码 依赖 于 具体 设备 。 

在 OCF 规范 中 使 用 的 属性 名 称 和 属性 值 如 下 。 

CD 属性 名 称 :“ 键 值 对 ”中 的 * 键 "。 属 性 名 称 是 区 分 大 小 写 的 .并 且 其 数据 类 型 是 字符 串 类 型 ,但 
是 只 允许 ASCII 字符 串 ,不 允许 嵌入 NUL 字符 。 

(2) 属性 值 :“ 键 值 对 ”中 的 “ 值 ”"*。 当 数据 类 型 是 字符 串 时 ,属性 值 是 区 分 大 小 写 的 。 枚 举 类 型 的 值 
只 能 是 ASCII 字符 。 

名 称 是 资源 的 人 性 化 名 称 , 即 一 个 特定 的 资源 实例 名 称 ( 如 MyLivingRoomLight) ,名 称 属性 在 
表 3-1 中 进行 了 定义 。 

表 3-1 名 称 属性 的 定义 


属性 | 属性 名 | 属性 值 类 型 | 属性 值 规则 | 单位 | 访问 模式 | 是 否 强制 描 x 


可 理解 的 资源 名 称 ; 可 以 被 本 地 设置 或 远 
程 设置 (例如 ,由 一 个 用 户 进行 设置 ) 








名 称 n 字符 串 读 E 


























对 于 一 个 资源 的 特定 实例 来 说 ,资源 标识 符 属性 应 该 是 唯一 的 实例 标识 符 ( 在 整个 主机 服务 器 端的 
范围 内 )。 该 标识 符 的 编码 是 依赖 于 设备 和 实现 的 ,资源 标识 符 属性 的 定义 如 表 3-2 所 示 。 





34 «|| OCF 技 术 原理 及 物 联 网 程序 开发 指南 


表 3-2 资源 标识 符 属性 的 定义 
































m tt | 属性 名 | 属性 值 类 型 | 属性 值 规则 | 单位 | 访问 模式 | 是 否 强制 moo 
资源 标识 符 | D | cap | 依赖 实现 写 se 
资源 中 ) 
3.4 资源 类 型 


资源 类 型 是 指 一 类 资源 ,而 一 个 资源 是 资源 类 型 的 具体 实例 。 也 就 是 说 ,资源 类 型 定义 了 一 类 资 
源 。 一 个 资源 的 资源 类 型 是 通过 使 用 资源 类 型 公共 属性 来 声明 的 ,或 者 是 在 使 用 了 资源 类 型 参数 的 链 
接 中 声明 的 。 

资源 类 型 可 以 是 预定 义 的 (例如 ,在 OCF 规范 中 的 核心 资源 类 型 或 垂直 域 规范 中 的 资源 类 型 ) ,也 
可 以 是 自 定义 的 , 申 制造 商 终端 用 户 或 者 设备 开发 人 员 定 义 ( 例 如 ,供应 商定 义 的 资源 类 型 )。 资 源 类 
型 及 其 定义 细节 可 以 通过 外 部 (例如 ,通过 文档 ) 传 输 , 也 可 以 通过 使 用 API,\ 应 用 程序 下 载 和 使 用 的 元 
数据 来 进行 明确 定义 。OCEF 推荐 使 用 RAML 或 JSON 模式 明确 定义 资源 类 型 。 

每 一 个 资源 类 型 都 会 有 一 个 ID 来 标识 ,资源 类 型 ID 是 一 个 分 段 的 小 写字 符 串 , 各 段 之 间 用 “. "B 
开 。 整 个 字符 串 表 示 资 源 类 型 ID。 当 定义 ID 时 ,每 一 段 可 能 会 表示 适用 于 该 资源 类 型 的 任何 语义 。 
例如 ,每 段 都 可 以 表示 一 个 命名 空间 。 一 旦 ID 被 定义 ,ID 应 该 被 非 透明 地 使 用 ,而 不 是 从 每 个 段 中 推 
断 出 任何 信息 。 当 字符 串 "oic" 用 作 资源 类 型 ID 定义 的 第 一 段 时 ,该 字符 串 被 保留 为 OCF 定义 的 资源 
类 型 。 资 源 类 型 ID 可 以 用 于 寻找 资源 类 型 的 定义 .可 以 作为 权威 的 引用 。 属 性 名 称 和 属性 值 都 是 区 分 
大 小 写 的 ,并 且 *rt" 属 性 中 的 资源 类 型 TD ,应 该 以 区 分 大 小 写 的 方式 进行 比较 。 

3.4.1 资源 类 型 属性 

当 一 个 资源 被 实例 化 或 创建 时 ,资源 应 该 具有 一 个 或 多 个 资源 类 型 ,这 些 资源 类 型 是 作为 资源 模板 
的 。 资 源 所 遵守 的 资源 类 型 应 该 使 用 资源 的 “rt" 公 共 属性 进行 声明 。 对 于 用 作 标 准 的 资源 类 型 “rt" 公 共 
属性 的 属性 值 应 该 是 一 个 资源 类 型 ID 的 列表 ( 即 "rt" 一 < 资源 类 型 ID 列表 >)。 资 源 类 型 公共 属性 定义 如 
K 3-3 所 示 。 资 源 类 型 可 以 在 用 户 ( 即 客户 端 ) 和 资源 主机 ( 即 服务 器 端 ) 之 间 被 明确 地 发 现 或 隐 式 地 共享 。 

表 3-3 资源 类 型 公共 属性 定义 


JR 性 | 属性 名 | 属性 值 类 型 | 属性 值 规则 | 单位 | 访问 模式 | 是 否 强制 LEE: 


属性 名 “rt” 是 在 IETF RFC 6690 中 
具体 定义 的 








资源 类 型 | rt FEP | 属性 类 型 的 ID 读 是 


























3.4.2 资源 类 型 定义 


在 OCF 规范 中 ,资源 类 型 声明 如 下 。 

CD 预定 义 的 URI( 可 选 ): 在 一 个 OCF 规范 中 ,可 以 为 一 个 特定 的 资源 类 型 指定 一 个 预定 义 的 
URI。 当 一 个 资源 类 型 有 一 个 预定 义 的 URI 时 .该 资源 类 型 的 所 有 实例 将 只 使 用 这 个 预定 义 的 URI. 
其 他 资源 类 型 的 实例 不 会 使 用 该 预定 义 的 URI。 

(2) 资源 类 型 名 称 (可 选 ): 指明 资源 类 型 的 人 性 化 名 称 。 
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(3) 资源 类 型 ID:“rt" 属 性 的 值 ,指明 了 资源 类 型 (如 “oic. wk. p”) ,由 多 个 段 组 成 的 小 写字 母 字符 
串 , 各 段 之 间 用 ”*. " 隔 开 ; 每 段 可 能 表示 一 个 命名 空间 ,后 一 段 (从 左 到 右 ) 表 示 的 就 是 前 一 段 的 子 命名 
空间 ; 在 实现 的 过 程 中 会 不 透明 地 使 用 这 些 段 ,并 且 使 用 区 分 大 小 写 的 字符 串 匹配 。 

(4) 资源 接口 : 该 资源 类 型 可 能 支持 的 一 些 接口 。 

(5) 资源 属性 : 应 用 于 一 个 资源 类 型 的 所 有 属性 的 定义 。 资 源 类 型 的 定义 中 ,应 该 规定 一 个 属性 是 
强制 的 ,在 某 种 条 件 下 是 强制 的 还 是 可 选 的 。 

(6) 相关 资源 类 型 (可 选 ): 可 以 作为 该 资源 类 型 一 部 分 ,是 被 引用 的 其 他 资源 类 型 规范 ,也 适用 于 

^ 

(7) Mime 类 型 (可 选 ): 包括 序列 化 资源 支持 的 Mime 类 型 (如 application/cbor application/json 
和 application/xml) 。 

K 3-4 3 3-5 将 一 个 foobar 资源 类 型 及 其 相关 属性 ,作为 一 个 例子 进行 了 描述 。 


表 3-4 foobar 资源 类 型 示例 





预定 义 的 URI | 资源 类 型 名 称 | MAID | 资源 接口 | 措 ak | 相关 的 功能 交互 | 强制 /条 件 /可 先 
(*rt” 属 性 的 值 ) 
x foobar oic. r. foobar oic. if.a | foobar 资源 示例 驱动 可 选 


表 3-5 foobar 属性 示例 














Mm 性 属性 名 属性 值 类 型 属性 值 规则 单位 | 访问 模式 | 是 否 强制 描 x 
资源 类 型 rt 字符 串 读 是 资源 类 型 
资源 接口 if 字符 串 读 是 接口 
资源 值 value 字符 串 读 是 属性 




















foobar 资源 类 型 的 实例 如 下 所 示 。 
{ 


"rt": ["oic.r. foobar" ], 
"48"; ["oie. 1E.à"], 
"value": "foo value" 


) 
foobar 资源 类 型 的 示例 Schema 如 下 所 示 。 


{ 

" $ schema": "http://json— schema. org/draft — 04/schema" , 
"type": "object", 

"properties": ( 

"rt": ("type": "string"}, 

"if": ("type": "string"), 

"value": ("type": "string"] 

h 

"required": ["rt", "if", "value"] 

) 


3.4.3 St BAR 


多 ”rt" 值 资源 是 指 具 有 多 种 资源 类 型 。 这 样 的 资源 与 多 个 资源 类 型 相关 联 , 因 此 它 的 "rt" 属 性 值 具 
有 多 个 资源 类 型 ID( 如 "rt" : ["oic. r. switch. binary", "oic. r. light. brightness"])。“rt” 属 性 值 中 资源 
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类 型 ID 的 顺序 是 无 意义 的 。 例 如 ,"rt":["oic. r. switch. binary", "oic. r. light. brightness"] 和 "rt": 
["oic. r. light. brightness", "oic. r. switch binary"] 具 有 相同 的 含义 。 

资源 类 型 为 多 “rt" 值 的 资源 应 满足 以 下 条 件 。 

CD 属性 名 称 除 了 * 公 共 属 性 ?以 外 .每 个 资源 类 型 的 属性 名 称 应 该 是 唯一 的 (在 多 *rt" 值 资源 的 范 
围 内 ) ,否则 会 出 现 冲 突 的 属性 语义 。 如 果 两 个 资源 类 型 具有 相同 名 称 的 属性 , 则 多 “rt”" 值 资源 不 应 由 
这 些 资源 类 型 组 成 。 

(2) 多 “rt” 值 资源 满足 每 种 资源 类 型 的 所 有 要 求 , 并 符合 每 个 组 件 资源 类 型 的 RAML/JSON 定义 。 
因此 ,多 “rt” 值 资源 的 强制 属性 应 为 每 种 资源 类 型 的 所 有 强制 属性 的 并 集 。 例 如 ,在 资源 “rt” 为 ["oic 
. r. switch, binary", "oic. r. light. brightness" ] 中 的 强制 属性 是 “ 值 ”" 和 “亮度 ”, 前 者 属于 “oic. r. switch 
.binary”, 后 者 属于 “oic. r. light. brightness", 

G) 多 “rt" 值 资源 接口 集合 应 是 组 件 资源 类 型 中 接口 集合 的 并 集 。 响 应 于 接口 上 的 CRUDN 操作 
资源 表示 应 为 该 接口 定义 模式 的 并 集 。 多 “rt” 值 资源 的 默认 接口 应 为 基准 接口 (“oic. if. baseline”) , 因 
为 这 是 资源 类 型 之 间 唯一 保证 的 通用 接口 。 

为 了 清楚 起 见 , 如 果 每 个 资源 类 型 支持 相同 的 一 组 接口 , 则 所 得 到 的 多 “rt" 值 资源 具有 相同 的 接口 
集 , 默 认 接口 为 “oic. if. baseline", 

对 多 “rt” 值 资源 的 默认 接口 “oic. if. a”*oic. if. s”“oic. if. r" 和 *oic. if. rw” 等 “rt” 查 询 是 通用 “rt" 查 询 
的 扩展 。 当 服务 器 端 收 到 带 有 “rt" 查 询 的 多 “rt" 值 资源 的 检索 请 求 ( 即 GET /ResExample? rt— oic. r 
.foo) 时 ,服务 器 端 应 当 在 查询 目标 为 多 "rt" 值 资源 某 一 项 “rt" 属 性 中 进行 响应 , 且 应 仅 返回 与 查询 相关 
联 的 属性 。 例 如 , 当 目 标 多 “rt” 值 资源 “rt”: [ "oic. r. switch. binary", "oic. r. light. brightness"j 在 接收 
到 使 用 “rt” 查 询 "GET /ResExample? rt — oic. r, switch. binary; "时 ,服务 器 端 只 响应 “oic. r, switch 
.binary” 的 属性 。 


3.5 设备 类 型 及 资源 接口 


设备 类 型 是 设备 的 类 。 定 义 的 每 个 设备 类 型 将 包括 该 设备 类 型 实现 的 最 小 资源 类 型 列表 。 设 备 可 能 
会 暴露 超出 最 小 列表 的 额外 标准 和 供应 商定 义 的 资源 类 型 。 设 备 类 型 用 于 资源 发 现 。 像 资源 类 型 一 样 ， 
设备 类 型 可 以 使 用 在 资源 类 型 公共 属性 中 或 资源 类 型 参数 的 链接 中 。 设 备 类 型 可 以 由 制造 商 、 最 终 用 户 、 
设备 的 开发 人 员 进 行 预定 义 或 自 定义 ,设备 类 型 及 其 定义 的 详细 信息 可 能 用 其 他 方式 交互 (如 文档 中 )。 

对 于 OCF 规范 的 接口 , 它 首 先 提供 了 资源 内 部 的 一 个 视图 ,然后 根据 资源 的 视图 定义 允许 的 请 求 
和 响应 ,是 由 接口 提供 的 视图 定义 了 对 这 个 资源 请 求 和 响应 的 上 下 文 。 因 此 ,对 于 一 个 资源 的 相同 请 
求 ,针对 不 同 的 接口 时 会 产生 不 同 的 响应 。 

资源 的 接口 可 以 由 OCF 规范 定义 ( 即 核心 接口 ) .也 可 以 由 OCF 垂直 域 规 范 来 定义 ( 即 垂直 接口 )， 
还 可 以 由 制造 商 ,终端 用 户 或 设备 的 开发 人 员 来 定义 ( 即 供应 商定 义 的 接口 )。 

资源 的 接口 属性 列 出 了 该 资源 支持 的 所 有 接口 。 任 何 的 资源 至 少 有 一 个 接口 。 默 认 接 口 应 由 
OCF 规范 定义 ,并 且 从 资源 类 型 的 定义 中 继承 。 在 OCF 规范 定义 中 ,与 资源 类 型 相关 的 默认 接口 ,应 
该 是 在 资源 类 型 中 定义 的 .可 用 枚 举 类 型 内 首先 被 列 出 的 支持 接口 。 在 一 个 OCF 规范 中 指定 的 所 有 默 
认 接 口 都 应 该 是 强制 的 。 

BR OCF 规范 定义 的 接口 之 外 ,所 有 的 资源 都 应 该 支持 基准 接口 (“oic. if. baseline") 。 当 请 求 选择 
使 用 一 个 接口 时 ,在 请 求 消息 的 资源 URI 中 .该 接口 应 该 被 指定 为 查询 参数 。 如 果 没 有 指定 查询 参数 ， 
就 会 使 用 默认 的 接口 。 如 果 选 择 的 接口 不 是 资源 所 允许 的 接口 ,那么 选择 该 接口 就 是 错误 的 。 
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一 个 接口 可 以 接收 多 个 媒体 类 型 ,也 可 以 用 多 个 媒体 类 型 来 响应 。 被 接收 的 媒体 类 型 可 以 不 同 于 
响应 的 媒体 类 型 。 在 传输 协议 中 ,媒体 类 型 是 使 用 合适 的 头 参数 来 指定 。 需 要 注意 的 是 该 特征 必须 合 
理 使 用 ,并 且 人 允许 在 线 上 优化 表示 ,每 个 接口 都 应 该 至 少 有 一 种 媒体 类 型 。 


3.5.1 接口 属性 


一 个 资源 所 支持 的 接口 应 该 使 用 接口 公共 属性 (如 表 3-6 所 示 ) 进 行 声明 ,格式 为 “if 一 < 接口 数组 >”。 
一 个 接口 属性 值 应 该 是 一 个 分 段 的 小 写字 符 串 ,各 段 之 间 用 “. ”分隔 开 。 当 接口 属性 的 第 一 段 中 使 用 
“oic” 时 ,该 接口 就 被 保留 为 OCF 定义 的 接口 。 接 口 属性 值 也 可 以 是 对 一 个 权威 的 引用 ,这 样 的 引用 可 
以 用 于 找到 一 个 接口 的 定义 ,一 个 资源 类 型 应 该 支持 一 个 或 多 个 接口 。 
表 3-6 资源 接口 属性 定义 























属性 | 属性 名 属性 值 类 型 | 属性 值 规则 单位 访问 模式 是 否 强 制 | 描 述 
声明 一 个 资源 所 支持 
接口 if JSON 用 点 分 隔 开 的 字符 串 数组 读 是 的 接口 的 属性 
3.5.2 接口 方法 


本 节 主 要 介绍 接口 的 定义 ,基准 接口 . 链 路 列表 接口 , 批 处 理 接口 ,执行 器 接口 .传感器 接口 ,只 读 接 
H . 读 写 接口 。 
1. 概述 
在 OCF 规范 中 ,定义 的 接口 如 表 3-7 所 示 。 
表 3-7 OCF 规范 中 定义 的 接口 



































& n 名 R 可 用 的 方法 Hook 
UE 基准 接口 定义 了 包括 原 属性 在 内 的 一 个 资源 的 所 有 属性 的 视 
基准 接口 oic. if. baseline 检索 、 更 新 图 。 该 接口 用 于 在 一 个 资源 的 完全 表示 上 进行 操作 
链 路 列表 接口 提供 了 一 个 集合 (资源 ) 中 链接 的 视图 。 由 于 链 
接 表示 与 其 他 资源 的 关系 ,该 接口 可 能 用 于 发 现 关于 一 个 上 
链 路 列表 接口 | oic if. Il 检索 下 文 的 资源 。 这 个 发 现 是 通过 检索 到 其 他 资源 的 链接 来 完成 
的 。 例 如 ,核心 资源 /oic/res 使 用 该 接口 ,以 允许 发 现 托管 在 
一 个 设备 上 的 资源 
批 处 理 接口 用 于 同时 与 一 组 资源 进行 交互 。 这 不 需要 客户 端 
批 处 理 接口 | oic. if. b 检索 、 更 新 首先 发 现 它 正在 操作 的 资源 ,服务 器 端 会 转发 请 求 并 聚合 
响应 
AEREO | oic. if.a 创建 .检索 .更 新 | 执行 接口 用 于 读 写 一 个 驱动 器 资源 的 属性 
传感器 接口 | oic. if.s 检索 传感器 接口 用 于 读 一 个 传感器 资源 的 属性 
只 读 接口 暴露 了 可 以 被 “ 读 * 的 资源 属性 。 该 接口 不 提供 方法 
REE? pose "a 来 更 新 属性 或 资源 ,因此 ,只 能 用 来 读 属性 值 
读 写 接口 只 暴露 了 既 可 以 被 读 又 可 以 被 写 的 属性 ,并 提供 了 
读 写 接口 oie. if. rw 检索 .更 新 人 
2. 基准 接口 


资源 的 所 有 属性 表示 ,包括 公共 属性 ,对 于 基准 接口 是 可 见 的 。 基 准 接口 是 为 所 有 的 资源 类 型 定义 
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的 , 即 所 有 的 资源 都 应 该 支持 基准 接口 。 

通过 将 “if 一 oic. if. baseline” 添 加 到 目标 资源 的 URI 的 查询 参数 中 ,就 选择 了 基准 接口 ,例如 GET/ 
oic/res? if=oic. if. baseline, 

D 检索 的 使 用 

基准 接口 可 以 用 来 检索 资源 的 所 有 属性 。 当 一 个 客户 端 检索 一 个 资源 的 所 有 属性 时 ,就 会 使 用 基 
准 接口 。 客 户 端 将 *? if=oic. if. baseline" 加 入 到 一 个 检索 请 求 中 ,服务 器 端 接收 到 请 求 时 ,会 将 此 时 所 
有 属性 的 表示 加 到 响应 中 。 如 果 服 务 器 端 不 能 返回 所 有 资源 的 表示 ,就 会 回复 一 个 错误 信息 ; 也 就 是 
说 ,服务 器 端 不 会 返回 部 分 资源 表示 。 

一 个 使 用 了 基准 接口 的 检索 请 求 示例 响应 如 下 所 示 。 


["oic. r. temperature" ], 
["oic. if.a","oic. if. baseline" ], 

"temperature": 20, 

"units": "C", 

"range": [0,100] 

) 

2) 更 新 的 使 用 

使 用 基准 接口 ,并 且 在 更 新 请 求 中 有 属性 及 其 期 望 值 的 列表 时 ,一 个 资源 的 所 有 属性 都 可 以 被 修改 。 

3. 链 路 列表 接口 

链 路 列表 接口 提供 了 一 个 集合 (资源 ) 中 链 路 列表 的 一 个 视图 。 通 过 该 接口 可 见 的 表示 只 有 链 路 ， 
该 链 路 在 属性 值 中 定义 。 因 此 ,该 接口 用 于 与 一 个 集合 中 的 链 路 列表 进行 操作 或 交互 。 通 过 使 用 该 接 
口 ,可 以 检索 到 链 路 列表 ,接口 定义 和 语义 如 下 。 

(1) 链 路 列表 接口 名 称 应 该 是 “oic. if. I”. 

(2) 如 果 请 求 中 有 定义 的 话 (通常 在 请 求 头 中 ) ,响应 中 的 序列 化 应 采用 请 求 定义 的 预期 格式 。 

(3) 在 链 路 列表 接口 检索 请 求 的 响应 中 ,被 引用 资源 的 URI 应 该 作为 一 个 URI 引 用 被 返回 。 

(4) 如 果 在 一 个 资源 中 显示 没有 链 路 , 则 返回 一 个 空 列 表 。 

(5) 由 该 接口 视图 定义 的 表示 只 包括 链 路 属性 值 。 

(6) 关于 链 路 列表 接口 示例 , 即 一 个 集合 的 请 求 表 示 ,例如 ,检索 在 房间 中 链 路 的 请 求 , 链 路 可 能 引 
用 灯 、` 风 扇 和 电 插座 等 ,如 GET oic://< devID >/a/room/1? if=oic. if. Il. 

4. 批 处 理 接口 

批 处 理 接口 通过 使 用 一 个 (相同 的 ?请求 与 资源 集合 进行 交互 。 批 处 理 接口 支持 集合 链 路 中 的 资源 
方法 ,并 且 可 以 使 用 一 个 资源 表示 来 检索 或 更 新 被 链接 的 资源 属性 。 

批 处 理 接口 选择 了 一 个 集合 链接 的 视图 ,将 请 求 发 送 到 该 视图 中 所 有 的 链 路 ,并 包含 可 能 修改 的 链 
路 参数 。 批 处 理 接口 定义 如 下 。 

C1) 批 处 理 接口 名 称 应 该 是 “oic. if. b”。 

(2) 具有 批 处 理 接口 的 资源 会 有 很 多 链 路 .这 些 链 路 会 有 资源 的 引用 ,这 些 引用 可 能 是 URI( 对 远 
程 资 源 完全 适用 ) 或 者 是 相对 引用 (用 于 本 地 资源 ) 。 

(3) 如 果 一 个 资源 的 链接 并 没有 指明 使 用 哪个 接口 (使 用 *bp” 链 接 参数 ) , 则 该 请 求 会 被 转发 到 被 
引用 资源 的 默认 接口 。 如 果 *bp” 使 用 *q” 关 键 字 指 明了 一 个 查询 , 则 该 查询 会 被 应 用 在 URI 的 查询 参 
数 中 (该 URI 是 由 引用 形成 的 ) ,以 选择 在 目标 资源 中 的 接口 。 

CA) 如 果 要 针对 资源 链接 中 的 每 个 对 象 修改 原始 请 求 以 创建 新 的 请 求 , 则 需要 将 原始 请 求 的 URI 
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替换 为 链接 中 目标 资源 的 URI。 新 请 求 中 的 有 效 荷载 可 以 直接 复制 原始 请 求 中 的 有 效 荷 载 。 

(5) 来 自 链接 资源 的 所 有 响应 都 应 集中 到 单个 响应 中 :发送 到 服务 器 端 。 服 务 器 端 会 根据 时 间 窗 
口 判断 响应 是 否 超时 ,如 果 时 间 窗 口 已 经 跟 客 户 端 进行 了 协商 . 则 服务 器 端 不 会 在 时 间 窗 口内 超时 ; 如 
果 没 有 协商 好 的 时 间 窗 口 ,服务 器 端 会 根据 情况 选择 合适 的 窗口 。 如 果 目 标 资源 不 能 处 理 新 的 请 求 ,就 
会 返回 空 响应 或 错误 响应 。 这 些 空 的 /错误 的 响应 会 包含 在 集中 响应 中 ,返回 到 原始 客户 端 。 

(6) 集合 响应 是 对 象 的 集合 ,每 个 对 象 都 是 单独 的 响应 。 集 合 中 的 每 个 响应 包含 至 少 两 项 : 完全 限 
定 的 URI RIR H “href”: < URI>; 在 响应 中 声明 的 表示 ,使 用 关键 字 *rep”, 即 “rep”: {< 在 单个 响应 中 
的 表示 >)。 

CT) 通过 向 原始 批 处 理 接口 请 求 处 理 的 集合 URI 中 添加 一 个 过 滤器 .客户 端 可 以 限制 请 求 转发 的 
链接 列表 。 

(8) 在 特定 链 路 请 求 表示 ,可 能 与 目标 资源 上 接口 暴露 的 表示 不 匹配 。 在 这 种 情况 下 ,使 用 PUT 
方法 的 更 新 操作 通常 会 失败 ,使 用 POST 方法 比较 合适 。 在 这 种 情况 下 ,如 果 请 求 中 的 属性 与 暴露 的 资 
源 视 图 属性 相 匹配 ,那么 子 集 语义 就 会 应 用 于 目标 资源 中 可 以 修改 的 属性 ,当然 ,属性 可 以 修改 的 前 提 
是 该 属性 是 可 写 的 。 

(9) 如 果 一 个 设备 支持 批 处 理 接口 ,那么 该 设备 应 该 既 实 现 客户 端 角色 ,又 实现 服务 器 端 角色 。 

一 个 批 处 理 接 口 的 例子 如 表 3-8 所 示 。 


表 3-8 批 处 理 接口 的 例子 


/a/room/1 
{ 
"rt": ["acne. room" ], 
"if": ["oic. if. baseline", "oic. if.b"], 
"color": "blue", 
"dimension": "15bxl5wxlOh", 
"links": [ 
{"href": "/the/light/1", 
"rt": ["acme. light"], 
"if": ["oic. if.a", "oic. if. baseline"], 
"ins": 1), 
["href" : "/the/light/2", 
"rt": ["nycorp. light"], 
if = ["oic. if.a" , "oic. if. baseline"], 
资源 "ins": 2), 
{"href": "/ny/fan/1", 
"rt": ["hiscorp. fan"], 
if = ["oic. if. baseline", "oic. if.a"], 
"ins": 3 ), 
{"href": "/his/fan/2", 
"rt": ["hiscorp. fan"], 
if = ["oic. if. baseline", "oic. if.a"], 
"ins": 4, "bp": ("q": "if = oic. if.a"}} 


J 


} 
/the/light/1 
t 
"rt": ["acne. light"], 


"if": ["oic. if. s", "oic.if.baseline"], 
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续 表 





"state": 0, 
"colortemp" : "2700K" 
} 
/the/light/2 
t 
"rt": ["nycorp. light"], 
"if": ["oic. if. a", "oic. if. baseline” ], 





"state": 1, 

"color": "red" 
) 
/my/fan/1 
{ 

xm "rt" : ["hiscorp. fan"], 

"if": ["oic.if.a", "oic. if.baseline"], 

"state": 0, 

"speed": "10" 
) 
/his/fan/2 
t 

"rt": ["hiscorp. fan"], 

"if": ["oic.if.a", "oic. if.baseline"], 

"state": 0, 

"speed": "20" 
) 
Request: GET /a/room/1? if = oic. if. b 
在 客户 端 中 由 设备 将 上 面 的 请 求 处 理 为 下 面 单个 的 请 求 。 
GET /the/light/1( 注 意 : 使 用 默认 接口 , 即 传感器 接口 ) 
GET /the/light/2( 注 意 : 使 用 默认 接口 , 即 传感器 接口 ) 
GET /my/fan/1( 注 意 : 使 用 默认 接口 , 即 基准 接口 ) 
GET /his/fan/2?if = oic. if.a( 注 意 : HA bp 链接 参数 的 接口 , 即 执行 器 接口 ) 
响应 : 
[ 

{ 

"href" : "oic://< devID»/the/light/1", 
"rep": ("state": 0, "colortemp": "2700K"} 
批 处 理 的 使 用 





{ 
"href": "oic://« devID»/the/light/2", 
"rep": ("state": 1, "color": "red" } 
Lh 
{ 
"href": "oic://« devID»/ny/fan/1", 


"rep": ( "rt": ["hiscorp.fan"], "if": ["oic.if.a", "oic. if.baseline"], "state": 0, 


"speed": "10" } 
} 
{ 
"href": "oic://« devID»/his/fan/2", 
"rep": ( "state": 0, "speed": "20" } 
3 
] 
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续 表 





UPDATE /a/room/1?if = oic. if. b 
{ 
"state": 1 
} 
批 处 理 的 使 用 | 变 为 : 
(有 POST 语义 | UPDATE /the/light/1 ( "state": 1 ) 
的 UPDATE) UPDATE /my/fan/1 ( "state": 1 } 
UPDATE /his/fan/2?if = oic. if.a ( "state": 1 } 


该 操作 打开 了 房间 内 的 所 有 灯 ( 除 了 “/the/light/1" 资 源 ) 和 风扇 ,因为 所 有 的 资源 都 有 “state” 这 一 


属性 。“/the/light/1” 默 认 接 口 是 传 感 器 ,因此 ,POST 不 支持 传感器 接口 (设备 主机 “/a/room/1" 不 
会 发 送 该 请 求 ) 





UPDATE /a/roon/1?if = oic. if. b 
t 

批 处 理 的 使 用 "state": 1, 

(有 POST 语义 "color": "blue" 

MP UPDATE) |} 
该 操作 打开 了 房间 中 所 有 的 灯 ( 除 了 */the/light/1" 资 源 之 外 ) 和 风扇 ,也 将 */the/light/2" 的 颜色 设 
置 为 蓝 色 


K 3-9 更 进一步 展示 了 链 路 列表 和 批 处 理 接口 。 
表 3-9 链 路 列表 和 批 处 理 接口 示例 


/myexample 
{ 
"xt": ["oic. z. £00" ], 
"if": [ "oic. if. baseline", "oic. if.11" ], 
"links": [ 
("href" : "/acne/switch", 
示例 "di": "<deviceID1 >", 
m "rt": ["oic.r. switc. binary" ], 
PA£V :-|[ "oic. 1£.8"]]; 
("href": "oic://« deviceID1 >/acme/fan", 
"rt": ["oic.r.fan"], 


"if": ["oic.if.a"] } 





] 
} 
GET /myexample? if = oic. if. baseline 
{ 


"xt": ["oic.r.foo"], 
"if": [ "oic. if. baseline", "oic. if. 11" ], 
"links": [ 
{"href": "/acme/switch", 
"di": "< deviceIDl >", 
"rt": ["oic. r. switc. binary"], 
"if": ["oic. if.a"]}, 


基准 接口 的 使 用 


{"href": "oic://« deviceID1 >/acme/fan", 
"rt": "oic.r.fan", "if": "oic. if.a"} 


] 
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续 表 





GET /myexample?if = oic. if.11 
(" hre£" : " /acne/suitch", 
"di": "< deviceID1 >", 








链 路 列表 接口 的 e 
"rt": ["oic.r. switc. binary"], 
使 用 "if": ["oic. if.a"]], 
("href" : "oic://« deviceID1 >/acme/fan", 
"rt": ["oic.r.fan"], "if": ["oic. if.a"]) 
] 
5. 执行 器 接口 


选 属 


执行 器 接口 是 用 于 查看 可 以 被 驱动 的 资源 接口 , 即 改变 由 资源 抽象 出 来 的 某 个 实体 内 的 值 或 状态 。 
CD 执行 器 接口 的 名 称 应 该 是 “oic. if. a”. 

(2) 执行 器 接口 在 资源 表示 中 暴露 所 有 强制 属性 ,属性 由 可 用 的 JSON 定义 ; 执行 器 接口 会 暴露 可 
性 , 它 由 目标 设备 中 实现 的 .可 用 的 JSON Schema 定义 。 

加 热 器 资源 如 下 所 示 ,“prm” 是 参数 属性 的 名 称 。 


/a/act/heater 


"rt": ["acne.gas"], 

"if": ["oic. if. baseline", "oic. if.r", "oic.if.a"], 

"prn": ("sensitivity": 5, "units": "C", "range": "0 .. 10"), 
"settemp": 10, 

"currenttemp" : 7 


) 


根据 加 热 器 资源 ,执行 器 接口 说 明 如 下 。 
CD 检索 一 个 驱动 器 的 值 。 


Request: GET /a/act/heater?if = "oic. if. a" 

Response: 

{ 

"prn": ("sensitivity": 5, "units": "C", "range": "0 .. 10"), 
"settenp": 10, 

"currenttemp" : 7 


) 
(2) 驱动 器 的 正确 使 用 。 


Request: POST /a/act/heater?if = "oic. if.a" 
{ 

"settemp": 20 

} 

Response: 

{ 

Ok 


) 
(3) 驱动 器 的 不 正确 使 用 。 


Request: POST /a/act/heater?if = "oic. if.a" 
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"if": "oic.if.s" ?对 baseline 接口 可 见 


(4) 使 用 该 接口 的 检索 请 求 .会 返回 符合 可 能 存在 的 资源 表示 ,这 些 资源 表示 可 以 针对 任何 查询 和 
过 滤器 参数 。 

(5) 使 用 该 接口 的 更 新 请 求 ,会 提供 一 个 有 效 荷 载 或 者 是 包 体 , 其 中 包含 目标 资源 可 能 或 需要 更 新 
的 属性 。 

O 如 果 一 个 资源 使 用 了 该 接口 ,会 返回 使 用 一 个 媒体 类 型 的 表示 ,并 使 用 CBOR (Concise Binary 
Object Representation, ,简明 二 进 制 对 象 表示 ) 编 码 , 如 IETF RFC 7049 中 所 定义 的 。 未 来 可 能 会 定义 
其 他 的 媒体 类 型 ,以 修改 在 返回 值 中 的 细节 。 

6. 传感器 接口 

传感器 接口 用 于 资源 检索 被 测量 的 被 感知 的 或 者 是 特定 能 力 的 信息 ,主要 包括 : 

CL) 传感器 接口 的 名 称 是 *oic. if. s”。 

(2) 传感器 接口 会 在 资源 表示 中 ,暴露 所 有 强制 属性 ,由 可 应 用 的 JSON 定义 ; 传感器 接口 也 会 暴 
露 由 目标 设备 实现 的 可 选 属性 ,也 由 JSON 定义 。 

(3) 使 用 该 接口 的 检索 请 求 , 会 返回 符合 可 能 存在 的 资源 表示 , 它 可 以 相对 于 任何 查询 和 过 滤器 
参数 。 
(4) 如 果 一 个 资源 使 用 了 该 接口 ,会 返回 使 用 一 个 媒体 类 型 的 表示 ,并 使 用 CBOR 编码 ,如 IETF 
RFC 7049 中 所 定义 的 ,未 来 可 能 会 定义 其 他 的 媒体 类 型 ,以 修改 在 返回 值 中 的 细节 。 

传感器 接口 主要 包括 如 下 几 方 面 。 

CD 检索 一 个 传感器 的 值 。 

Request: GET /a/act/heater? if = "oic. if.s" 

Response: 

{ 


"currenttemp": 7 


} 
(2) 传感器 的 不 正确 使 用 。 


Request: PUT /a/act/heater?if = "oic. if. s" / [PUT 是 不 允许 的 

i "settemp" : 20 // 这 可 以 通过 执行 器 接口 实现 
NE, 

: Error 


G) 传感器 的 不 正确 使 用 。 


Request: POST /a/act/heater?if = "oic. if. s" //P0ST 是 不 允许 的 
{ 
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"currenttemp": 15 // 这 可 以 通过 执行 器 接口 实现 


7. 只 读 接口 

只 读 接口 暴露 可 能 会 被 * 读 ”的 属性 ,包括 “只 读 ” 属 性 “ 读 写 ”属性 等 ,但 却 不 包括 “只 写 ” 属 性 和 “只 
设置 "属性 。 能 够 使 用 的 方法 只 有 检索 ,客户 端 如 果 想 尝试 检索 之 外 的 方法 ,就 会 被 拒绝 ,还 会 产生 错误 
响应 代码 。 

8. 读 写 接口 

读 写 接口 只 会 暴露 可 能 会 被 * 读 ”和 *“ 写 "的 属性 。 这 表明 ,“ 只 读 ” 属 性 不 会 包含 在 读 写 接口 的 表示 
中 。 可 应 用 的 方法 只 有 检索 和 更 新 。 同 样 地 ,客户 端 如 果 想 尝试 其 他 的 方法 请 求 会 被 拒绝 ,会 产生 错误 
响应 代码 。 


3.6 资产 结构 


在 外 部 的 可 见 性 和 资源 属性 的 可 操作 快照 以 及 在 一 个 时 间 点 上 各 自 的 值 被 称 为 资源 表示 。 资 源 表 
示 抓 住 了 特定 时 间 一 个 资源 的 状态 。 当 资源 进行 交互 时 ,资源 表示 在 请 求 和 响应 中 被 交换 。 资 源 表 示 
可 以 用 于 检索 或 更 新 一 个 资源 的 状态 。 资 源 表示 不 应 该 被 数据 连接 协议 和 技术 (例如 ,CoAP、UDP/IP 
或 低 功 耗 蓝牙 ) 所 操作 。 

在 很 多 场景 中 ,资源 之 间 可 能 会 有 一 个 隐 式 或 显 式 的 结构 。 例 如 ,一 个 结构 可 以 是 树 、 网 格 . 扇 出 或 
扇 人 。 框 架 提供 了 对 这 些 结构 ,资源 间 的 关系 建 模 和 映射 方法 。 框 架 中 资源 结构 的 主要 构件 是 集合 。 
一 个 集合 表示 一 个 容器 ,该 容器 是 可 以 扩展 的 ,以 便 对 复杂 结构 进行 建 模 。 


3.6.1 资源 关系 


资源 关系 表示 为 链接 。 链 接 包 含 并 扩展 了 典型 的 Web 链接 概念 ,作为 一 种 表示 资源 之 间 关 系 的 方 
法 。 一 个 链接 包含 一 系列 参数 ,这 些 参 数 定义 如 下 。 

(D —T.ET X URI, 

(2) 一 个 目标 URI 

(3) 从 上 下 文 URI 到 目标 URI 的 关系 。 

(4) 提供 关于 目标 URI、 链 接 的 关系 或 上 下 文 元 数据 的 元 素 。 

除了 目标 URI 是 强制 的 外 ,链接 中 的 其 他 项 是 可 选 的 。 链 接 中 的 附加 项 可 能 会 根据 不 同上 下 文中 
链接 的 使 用 而 被 设置 为 强制 的 (例如 ,在 集合 中 ,发 现 中 和 桥接 中 等 )。 

链接 的 例子 如 下 所 示 。 





{"href":"/switch", "rt":["oic. r. switch. binary"], "if":["oic. if. a",/room2"oic. if. baseline"], "p":{"bm": 

3), "rel" :"item"} 

只 要 有 一 个 参数 不 同 , 这 两 个 链接 就 是 不 同 的 。 例 如 ,以 下 两 个 链接 是 不 同 的 ,可 以 在 同一 个 链 路 
列表 中 出 现 。 
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("hre£" : "/switch", "rt": ["oic.r.switch.binary"], "if": ["oic. if.a", "oic. if. baseline"], "p":{"bm":2}, 
kar eret: "rt": ["oic. r. switch. binary"], "if": ["oic. if.a", "oic. if.baseline"], "p":{"bm":2}, 
"rel": "activates"] 

当 需 要 特定 的 能 力 时 ,该 规范 可 能 要 求 很 多 参数 和 参数 值 。 对 于 在 “/oic/res” 上 的 检索 请 求 返回 的 
所 有 和 链接, 如果 一 个 链接 没有 显 式 包括 “rel” 参 数 , 则 默认 rel= hosts. hosts 相关 值 是 由 IETF RFC 
6690 定义 ,并 在 用 于 链接 关系 的 IANA(Internet Assigned Numbers Authority, 互 联网 数字 分 配 机 构 ) 
进行 注册 ,网 址 为 http://www. iana. org/assignments/link-relations/link-relations. xhtml, 

一 个 链接 中 上 下 文 URI 和 目标 URI 之 间 的 关系 使 用 "rel"JSON 元 素 进行 声明 ,并 且 该 元 素 的 值 指 
明了 特定 的 关系 。 

链接 的 上 下 文 URI 应 该 隐 式 地 成 为 包含 链 路 资源 (或 者 是 一 个 集合 ) 的 URI, 除 非 该 链 路 指明 了 一 
个 “anchor” 参 数 。“anchor" 用 于 改变 一 个 链 路 的 上 下 文 URI 一 一 如 果 该 参数 被 指明 的 话 ,与 目标 URI 
的 关系 是 基于 该 参数 URI 的 。 该 参数 使 用 OIC 1. 1 链接 的 传输 协议 URI( 如 “anchor”:“coaps: // 
[fe80::bld6]:44444”) 和 OCF 1. 0 链接 (如 “anchor”*ocf://dc70373c-le8d-4fb3-962e-017eaa863989”)。 

在 集合 的 上 下 文中 使 用 “anchor” 的 例子 如 下 。 一 层 楼 有 很 多 房间 ,房间 里 有 灯 可 能 会 作为 链接 被 
定义 在 房间 中 ,但 是 这 些 链 接应 该 有 “anchor” 参 数 . 该 参数 被 设置 为 包含 该 灯 房 间 的 URI( 关 系 为 包含 
关系 )。 这 就 允许 一 层 楼 上 所 有 的 灯 同 时 被 打开 或 关上 ,同时 仍然 有 灯 在 定义 时 与 包含 它们 的 房间 相关 
( 灯 也 可 以 通过 使 用 房间 URI 打开 )。 在 链接 中 使 用 “anchor” 的 示例 如 下 。 


/a/floor { 
"links": [ 
{ 
"href": "/x/lightl", 
"anchor": "/a/room1", 
// 注 意 :/a/rooml 具有 与 /x/1ight1 的 关系 ,不 是 /a/floor 
"rel": "item" 
) 
1 
) 
/a/roomi { 
"Rinks": if 
{ 
// 注 意 :/a/rooml 包含 /x/1ight, 由 于 /a/rooml 是 隐 式 的 URI 
"href": "/x/light1", 
"rel": "item" 
} 
] 
) 


1. 参数 

一 个 链接 包含 一 系列 参数 ,本 节 介 绍 “ins”( 链 接 实例 ) 参 数 “p”( 策 略 ) 参 数 “type”( 媒 体 类 型 ) 参 
数 “bp”( 批 处 理 接口 ) 参 数 di" GE ID) 参 数 和 “eps” 参 数 。 

1) “in” BH 

“ins” 参 数 指明 了 一 个 链接 列表 中 一 个 特定 的 链接 实例 。“ins” 参 数 常 被 用 于 在 一 个 链接 列表 中 修 
改 或 删除 一 个 特定 的 链接 。 当 一 个 链接 被 拥有 链接 列表 的 OCF 设备 (服务 ) 实 例 化 时 ,“ins” 参 数 的 值 
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被 设置 ,一 旦 被 设置 ,只 要 该 链接 是 其 列表 的 成 员 ,“ins" 参 数 就 不 会 被 修改 。 

2)“p” 参 数 

策略 参数 定义 了 正确 获取 一 个 目标 URI 所 引用 资源 的 各 种 规则 ,策略 规则 是 由 一 系列 键 值 对 配置 
的 ,策略 参数 “p" 定 义 如 下 。 

“bm” 键 : 对 应 于 一 个 整 型 值 ,该 整 型 值 被 解释 为 一 个 8 位 掩 码 。 位 掩 码 中 的 每 一 位 对 应 于 一 个 特 
定 的 策略 规则 ,为 “bm” 指 定 了 规则 ,如 表 3-10 所 示 。 


表 3-10 “bm” 键 指定 规则 




















比特 位 置 | 策略 规则 注 # 
定义 了 链接 是 否 会 通过 oic/res 被 包含 在 资源 的 发 现 消息 中 ,如 果 链 接 会 被 包含 在 资 
比特 0 可 发 现 源 发 现 消息 中 ,“p" 会 包括 “bm" 键 ,并 且 将 可 发 现 比特 的 值 置 为 1。 如 果 资 源 发 现 消 
息 中 不 包括 该 链接 , 则 “p” 可 以 选择 包含 “bm” 键 并 将 可 发 现 值 置 为 0 或 者 是 省 略 
“bm” 键 的 值 
定义 了 目标 URI 所 引用 的 资源 是 否 支 持 通 知 操作 。 如 果 资 源 支 持 通知 操作 , 则 “p” 
比特 1 可 观察 应 该 包括 “bm” 键 ,并且 将 可 观察 位 的 值 置 为 1; 如 果 该 资源 不 支持 通知 操作 ,“p” 可 
以 选择 包括 "bm" 键 并 将 可 观察 位 设置 为 0 或 者 是 省 略 "bm" 键 
比特 2 一 7 保留 用 于 以 后 使 用 ,“bm" 中 的 所 有 保留 位 的 值 都 应 该 被 设置 为 0 


注意 ,如 果 “bm” 中 的 所 有 比特 值 都 置 为 0, 则 为 提高 效率 ,可 以 从 “p” 中 将 "bm" 键 完全 省 略 。 然 而 ， 
如 果 有 任何 一 比特 值 被 置 为 1, 则 “p” 就 应 该 包含 “bm”, 所 有 的 比特 都 应 该 被 合适 地 定义 。 

“sec” 和 “port” 仅 在 OIC 1. 1 有 效 载荷 中 使 用 。 在 OCF 1.0 有 效 载荷 中 ,不 应 使 用 “sec” 和 *port”， 
而 是 通过 “eps" 参 数 提供 加 密 链 接 的 信息 。 

"sec" fit; 对 应 于 一 个 布尔 值 ,该 值 定义 了 目标 URI 引用 的 资源 是 否 是 通过 一 种 加 密 链 接 被 获取 到 
的 。 如 果 *sec” 为 真 , 则 是 通过 加 密 链 接 访 问 资源 ,使 用 “port” 规 范 ( 见 下 文 ); 如 果 “sec” 为 假 , 则 资源 是 
通过 未 加 密 的 链接 或 通过 加 密 链接 来 访问 资源 (如 果 这 样 的 链接 是 使 用 另 一 个 资源 的 “port" 设 置 进行 
AY "sec HEL), 

“port” 键 : 对 应 于 一 个 整 型 值 ,该 值 用 于 指明 目标 URI 所 引用 的 资源 可 以 通过 加 密 链 接 被 获取 到 
的 端口 号 。 

如 果 该 资源 只 能 通过 加 密 链 接 访 问 (例如 DT LS) ,那么 "p" 中 应 该 包括 *sec" 的 值 并 设 为 真 。“p” 中 
应 包含 “port" 键 ,并 且 将 “port” 的 值 设置 为 用 于 获取 资源 的 端口 号 。 

如 果 资 源 不 是 通过 加 密 链 接 访 问 的 .那么 “p” 应 该 包括 "sec” 键 , 它 的 值 应 该 为 假 。 或 者 "*p” 应 该 省 
略 “sec” 键 ; 默认 的 “sec” 值 为 假 。“p” 应 该 省 略 "port” 键 。 

若 该 资源 既 不 是 通过 加 密 链 接 也 不 是 通过 非 加 密 链 接 访问 的 , 则 遵循 本 节 定 义 的 补充 方案 。 通 过 
端口 键 指定 端口 上 的 资源 访问 应 通过 加 密 链 接 ( 例 如 *coaps: //”) 进 行 (请 注意 ,在 通过 多 播发 现 的 单 
独 端口 上 可 能 存在 与 资源 的 未 加 密 链 接 ) 。 

请 注意 ,资源 的 访问 由 资源 的 接 人 控制 列表 控制 ,成功 的 加 密 链 接 不 能 确保 所 请 求 的 操作 成 功 。 它 
是 OCF 安全 访问 控制 的 一 部 分 。 

例 3-1: 对 于 一 个 可 以 被 发 现 但 不 可 被 观察 ,可 以 通过 CoAPS 端口 33275 进行 认证 访问 的 资源 策 
略 ,参数 示例 如 下 。 


"p": { "bm":1 } 
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例 3-2: 如 下 展示 一 个 自 链接 ,例如 .在 自身 内 部 的 可 以 被 发 现 和 观察 的 "/oic/res” 链 接 。 
{ 


"href" :"/oic/res", 

"rel" :"self", 

"rt": ["oic. wk. res" ], 

"4f" :["oic. if. 11", "oic. if. baseline" ], 

"p ("ba :3} 

) 

3) "type" BR 

“type" 参 数 可 以 用 于 指明 一 个 特定 的 目标 资源 所 支持 的 各 种 媒体 类 型 。 当 "type" 元 素 被 省 略 时 ， 
“application/cbor” 类 型 的 默认 值 会 被 使 用 。 一 旦 一 个 客户 端 对 每 个 资源 都 发 现 了 该 信息 ,那么 在 请 求 
或 响应 合适 的 头 部 域内 就 会 选择 其 中 可 使 用 的 一 个 。 

4) “bp" BR 

“bp” 参 数 用 于 指定 对 目标 URI 的 修改 ,因为 批 处 理 请 求 是 通过 该 链 路 转发 的 。 值 中 的 “q" 元 素 定 
义 了 要 附加 到 “href” 的 查询 字符 串 以 构成 目标 URI.“q" 查 询 字符 串 可 以 包含 在 该 上 下 文中 有 效 的 多 
个 属性 字符 串 。 例 如 ,给 定 一 个 集合 如 下 。 


/roon2 
{ 
"i£": "oic.if.b", 
"color": "blue", 
"links": 
[ 
{"href": "/switch", "rt": ["oic.r. switch. binary"], "if": ["oic. if.a", "oic. if. baseline" ],"p":{"bm": 
2), "rel": "contains", "bp": ( "q": "if = oic. if. baseline" } 

) 
] 
) 


下 面 是 到 */room2” 的 批 处 理 请 求 序列 GET /room2? i[— oic. if. b, 当 批 处 理 请 求 通过 链接 被 传播 
到 目标 */switch” 时 ,该 请 求 被 传输 到 GET /switch? if=oic. if. baseline, 
5)“di” 参 数 
“di 参数 指定 了 承载 “href" 参 数 中 定义 目标 资源 的 设备 ID。 设 备 ID 可 以 用 于 限定 在 “href" 中 的 相 
对 引用 或 查找 相对 引用 的 端点 信息 。 
6) “eps” 参 数 
“eps” 参 数 指出 了 目标 资源 的 终端 信息 。“eps” 用 一 个 数组 作为 其 值 .每 一 个 数组 的 ep” 和 “pri” 组 
合 代表 一 个 终端 信息 。“ep” 是 强制 性 的 “pri" 是 可 选 的 。 
多 终端 的 “eps” 示 意 如 下 。 
"eps": [ 
{"ep": "coap://[fe80::b1d6]:1111", "pri": 2}, 
{"ep": "coaps://[£e80: :b1d6] :1122"], 
{"ep": "coap + tcp://[2001:db8:a::123]:2222", "pri": 3} 
1 
当 链 接 中 存在 “eps” 时 ,可 以 使 用 它 的 终端 信息 来 访问 由 *href” 参 数 引 用 的 目标 资源 。 当 “eps" 存 在 
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时 ,最 大 时 限 信息 决定 了 “eps” 的 存在 时 间 。 

2. 格式 及 链接 列表 

在 JSON 中 ,链接 列表 的 格式 是 一 个 数组 。 资 源 中 的 链接 列表 将 作为 该 资源 的 链 路 属性 的 值 包括 
在 该 资源 中 。 一 个 包含 链接 的 资源 是 一 个 集合 。 具 有 链接 列表 的 资源 如 下 所 示 。 

/Rooni 

{ 


"rt": ["ny. roon"], 





"if": ["oic. if. 11", "oic. if. baseline" ], 
"color": "blue" 

"links" 

[ 


"href": "/oic/d", 

"rt": ["oic.d.light", "oic.wk.d"], 
"if": [ "oic. if.r", "oic. if. baseline” ], 
"p": ("bm": 1} 


"href": "/oic/p", 

"rt": ["oic. wk. p"], 

"if": [ "oic. if.r", "oic. if. baseline" ], 
"p": "bm": 1) 


"href": "/switch", 

: [ "oic. r. switch. binary" ], 

"oic. if.a", "oic. if. baseline" ], 

: ("En" : 3), 

"application/cbor", "application/exi * xml" ] 








"href": "/brightness", 
ic. r.light.brightness"], 
"if": [ "oic. if.a", "oic. if. baseline" ], 








PR eau 
} 

] 

} 

3.6.2 集合 


一 个 包括 一 或 多 个 引用 其 他 的 资源 被 称 作 一 个 集合 。 这 些 引用 可 能 是 相关 的 ,也 可 能 只 是 一 个 列 
表 ; 并 且 该 集合 使 用 单个 句柄 来 引用 整个 集合 的 方法 。 任 何 资 源 都 可 以 通过 建立 资源 间 的 链接 和 指向 
变 成 集合 。 集 合 可 以 使 用 在 层次 .序号 .组 别 等 创建 .定义 和 具体 化 中 。 

在 一 个 集合 的 生命 周期 中 ,最 少 需要 固定 一 个 资源 类 型 和 一 个 接口 。 在 集合 创建 之 初 就 需要 将 资 
源 类 型 和 接口 绑 定 至 这 个 资源 ,并且 这 些 初始 的 变量 可 以 用 类 似 改写 资源 变量 的 方式 进行 改写 。 绑 定 
后 加 入 的 资源 类 型 和 接口 . 则 应 该 在 集合 生命 周期 中 完成 。 

集合 需要 定义 共有 链 路 属性 ,这 个 属性 的 值 应 为 一 个 包含 零 条 或 多 条 链接 的 数组 。 链 接 中 的 目标 
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URI 应 该 指向 另 一 个 集合 或 资源 ,其 中 ,被 指向 的 集合 或 资源 可 以 与 链接 的 发 起 方 在 同一 台 设 备 上 ,这 
样 的 链接 称 为 本 地 指向 ; 被 指向 的 资源 或 集合 也 可 以 挂 载 在 另 一 台 设 备 上 ,此 时 的 链接 称 作 远程 访问 。 
在 链 路 数组 中 代表 链接 的 URI 内 容 应 该 是 ( 隐 含 ) 那 些 包含 链 路 属性 的 集合 。 隐 含 的 URI 内 容 可 以 在 
之 后 通过 链接 中 的 “anchor" 属 性 进行 改写 ,这 里 的 “anchor” 属 性 值 是 链接 的 基础 。 

一 个 资源 可 以 被 多 个 集合 链接 ,因此 ,这 样 的 链接 和 指向 关系 并 不 能 保证 唯一 确定 的 “父子 ”关系 。 
在 一 个 确定 的 集合 与 其 指向 的 资源 间 并 没有 预先 定义 好 的 关系 ,例如 .可 以 使 用 集合 来 展现 一 个 具体 的 
关系 ,但 这 些 关系 并 不 是 自动 定义 或 隐 含 的 。 集 合 的 生命 周期 和 所 指向 的 资源 生命 周期 也 是 相互 独 
立 的 。 

如 果 集合 的 “drel” 属 性 已 经 定义 ,那么 所 有 没有 指定 联系 的 链接 则 会 继承 在 这 个 资源 配置 指令 中 
的 默认 值 。 关 系 的 默认 值 定义 了 链接 中 集合 和 目标 URI 之 间 隐 含 的 关系 。 

链 路 属性 表示 集合 中 的 链接 列表 。 链 路 属性 有 一 个 条 目 数 组 ,每 个 条 目 都 是 OCF 的 链接 ,如 图 3-2 
所 示 。 





Joco 


"rt" :["my. r. house"], 

"color" :"blue", 

"n" :"myhouse", 
"links":[--—-——-——-------------—------ ce cc 


[anom 


"href" :"/door", 
"rt" :["oic. r. door"], 
"if":["oic. if. b", "oic. if. 11", "oic. if. baseline"] 


snam 


"href" :"/door/lock", 

"rt" :["oic. r. lock"], 

if":["oic.if.b","oic. if. 11", "oic. if. baseline"], 
"type" : ["application/cbor","application/exi + xml"] 














图 3-2 集合 和 链接 示例 


集合 可 以 预先 定义 ,也 可 以 被 优先 定义 ,并 且 在 这 个 集合 的 生命 周期 中 都 是 静态 (稳定 ) 的 全 局 变 
量 。 这 样 的 集合 可 以 用 于 模型 (此 处 指 一 个 案例 ), 例 如 ,一 个 由 多 个 设备 或 一 些 固定 资源 组 成 的 应 用 可 
以 实现 固定 功能 。 

一 个 集合 若 只 能 用 于 配置 在 这 个 OCF 集合 里 的 设备 上 ,那么 该 集合 称 为 这 个 设备 的 本 地 集合 ,这 
样 的 集合 也 可 用 作客 户 端 上 指向 多 个 服务 器 端的 简便 形式 。 集 中 化 的 集合 是 指 配 置 在 一 个 OCF 设备 
上 ,并 能 被 其 他 OCF 设备 访问 或 更 新 的 集合 。 宿 主 集合 属于 集中 化 集合 ,但 由 一 个 或 多 个 代理 服务 器 
管理 控制 。 

1. 集合 的 属性 

集合 中 需要 定义 链 路 属性 。 除 此 之 外 ,还 需要 通过 资源 类 型 定义 多 个 其 他 的 属性 。 一 些 强制 的 、 推 
荐 的 集合 公共 属性 如 表 3-11 所 示 。 当 涉及 的 资源 属性 与 作为 资源 定义 的 属性 重复 时 ,在 集合 中 会 重 写 
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这 些 属性 。 
表 3-11 OCF 集合 的 公共 属性 (作为 公共 属性 的 补充 ) 
属 性 do Gk 属性 名 称 属性 值 类 型 是 否 强制 
链 路 集合 中 所 有 的 链接 links lm 是 
名 称 便于 人 们 理解 的 OCF 名 称 n Tm 否 
编号 OCF 集合 的 编号 id UUID 8 
资源 中 允许 链接 使 用 的 资源 类 型 的 列表 。 对 于 这 CSV 
资源 关 型 | 个 列表 ,增加 使 用 链接 列表 或 链接 批 处 理 接口 链接 | 。 格式 ， 由 去 号 分 隔 的 列 | 天 
的 请 求 是 有 效 的 。 如 果 这 个 属性 没有 定义 或 者 是 | “” 表 ,列表 中 是 OCF 资 
空 字符 串 , 则 任何 资源 类 型 都 是 可 用 的 源 的 类 型 名 称 
具体 规定 用 于 集合 中 的 OCF 链接 默认 的 关系 ,其 
默认 关系 | 中 “rel” 参 数 并 没有 被 明确 地 定义 。 人 允许 集合 和 | rel sam * 
OCF 链接 中 没有 定义 “drel” 属 性 和 “rel” 属 性 
2. 默认 资源 类 型 


默认 资源 类 型 “oic. wk. co” FE OCF 集合 中 可 用 。 这 种 资源 类 型 只 能 用 于 集合 中 没有 定义 别 的 资源 
类 型 或 在 集合 创建 的 时 候 没有 声明 资源 类 型 的 情况 下 。 

默认 资源 类 型 支持 公共 属性 和 链 路 属性 。 在 默认 资源 类 型 中 , 链 路 属性 的 值 应 该 是 一 个 简单 的 
OCF 链接 构成 的 数组 ,不 支持 使 用 含有 标记 的 链接 。 

默认 资源 类 型 需要 支持 基准 接口 和 链 路 列表 接口 ,默认 的 接口 应 该 是 链 路 列表 接口 。 


3.7 第 三 方 指定 扩展 


本 节 介 绍 第 三 方 如 何 将 设备 类 型 .资源 类 型 .第 三 方 定义 的 属性 添加 到 现 有 或 第 三 方 定义 的 资源 类 
型 . 枚 举 值 和 属性 中 去 。 

第 三 方 可 以 规定 OCF 设备 中 的 附加 ( 非 OCF) 资源 。 第 三 方 还 可 以 在 现 有 OCF 定义 的 资源 类 型 
中 规定 其 他 属性 。 此 外 ,第 三 方 可 以 使 用 它 定义 的 值 .扩展 OCF 定义 的 枚 举 。 

第 三 方 定义 的 设备 类 型 可 能 会 暴露 第 三 方 和 OCF 定义 的 资源 类 型 。 第 三 方 定义 的 设备 类 型 必须 
暴露 本 规范 中 定义 的 所 有 OCF 设备 必须 公开 的 资源 。 

被 第 三 方 定义 的 资源 类 型 应 包括 本 规范 中 定义 的 任何 强制 性 属性 以 及 任何 垂直 领域 指定 的 强制 属 
Tk. OCF 命名 空间 资源 类 型 中 被 第 三 方 定义 的 资源 属性 ,不 属于 OCF 规范 中 定义 的 常用 属性 ,应 该 遵 
循 表 3-12 中 第 三 方 定义 的 属性 规则 。 

表 3-12 第 三 方 定义 的 属性 规则 




















第 三 方 定义 资源 元 素 供应 商定 义 规则 
设备 类 型 /oic/d 的 资源 类 型 属性 值 x. <Domain_Name >. < resource identification > 
资源 类 型 属性 值 x. <Domain_Name >.< resource identification > 
OCF 命名 空间 中 的 属性 资源 属性 值 x. <Domain_Name >. < property > 
OCF 枚 举 规范 中 的 值 枚 举 属 性 值 x. < Domain, Name >. < enum value > 
OCF 属性 规范 中 的 参数 值 参数 键 值 x. <Domain_Name >. < parameter keyword > 
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关于 在 此 方案 中 使 用 的 Domain_Name. 其 标签 与 它们 在 DNS 或 其 他 解析 机 制 中 的 表现 方式 相反 。 
第 三 方 定义 的 设备 类 型 和 资源 类 型 请 遵循 资源 类 型 属性 中 定义 的 规则 。 第 三 方 定义 的 资源 类 型 应 在 
IANA 约束 下 的 RESTful 参数 注册 表 中 注册 。 举 例如 下 。 


x. com. samsung. galaxyphone. accelerator; 
X. com. cisco. ciscorouterport; 

x. com. hp. printerhead; 

x. org. allseen. newinterfae. newproperty. 
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CHAPTER 4 


OCF 资源 的 操作 








本 章 主要 介绍 OCF 资源 操作 的 方法 。 在 OCF 标准 中 ,主要 有 五 种 操作 ,分 别 是 创建 ,检索 、 更 新 、 
删除 和 通知 。 这 是 定义 对 OCF 资源 的 几 个 操作 ,一 般 称 为 CRUDN。OCF 客户 端 可 以 通过 这 些 方法 操 
作 OCF 服务 器 端 上 的 资源 。 


4.1 概述 


CRUDN 操作 使 用 了 在 消息 中 携带 的 一 系列 参数 ,这 些 参 数 在 表 4-1 中 进行 了 定义 。OCF 设备 可 
以 使 用 CBOR 作为 默认 负载 内 容 的 编码 方案 ,用 于 CRUDN 操作 和 操作 响应 中 包含 的 资源 表示 ; 同时 ， 
也 可 以 协商 出 一 个 新 的 负载 编码 方案 (例如 CoAP 消息 ) 。 本 章 的 内 容 将 会 明确 CRUDN 的 具体 操作 及 






































相关 参数 的 使 用 。 这 些 操作 的 类 型 定义 ,在 每 个 协议 中 都 会 映射 到 一 个 消息 块 中 。 
表 4-1 CRUDN 消息 的 参数 
适用 范围 名 称 意 x 定 X 
fr 发 送 者 消息 发 送 者 的 URI 
所 有 消息 to 接收 者 消息 接收 者 的 URI 
ri 请 求 标识 符 | 唯一 标识 消息 发 送 者 和 接收 者 间 消息 的 标识 符 
cn 内 容 具体 操作 的 信息 
FPR op 操作 具体 要 求 服务 器 端 执行 的 操作 
obs 观察 观察 请 求 的 标志 
响应 代码 请 求 结果 的 标志 ,表示 请 求 是 否 被 接收 以 及 操作 的 结果 。CRUDN 操作 
回复 i ii 的 返回 代码 应 遵守 IETF RFC 7252 规范 
obs 观察 观察 响应 的 标志 
4.2 创建 
创建 操作 用 来 在 服务 器 端 请 求 新 建 一 个 资源 。 客 户 端 初始 化 的 创建 操作 包括 三 个 步骤 ,如 图 4-1 
所 示 。 
1. 创建 请 求 


创建 请 求 消息 由 OCF 客户 端 发 送 到 OCF 服务 器 端 ,并 由 OCF 服务 器 端 创建 新 的 资源 。 创 建 请 求 
消息 将 包含 以 下 参数 。 
COD fr; OCF 客户 端的 唯一 标识 符 。 
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客户 端 服务 器 端 
1. 创建 请 求 
Y 
2. 服务 器 处 理 请 求 
3. 创建 响应 
1 1 
图 4-1 创建 操作 


(2) to: 负责 创建 新 目标 资源 的 URI。 
G) ri, 创建 请 求 的 标识 符 。 


CA) cn: 有 关 服 务 器 端 将 要 创建 的 资源 信息 ,包括 将 创建 资源 的 URI 和 资源 类 型 属性 ,可 能 包括 将 


被 创建 资源 的 其 他 属性 。 
(5) op: 创建 。 
2. OCF 服务 器 端 处 理 请 求 


在 收 到 创建 请 求 之 后 ,服务 器 端 会 验证 发 送 请 求 的 客户 端 是 否 具有 创建 所 需 资 源 的 权限 。 如 果 有 ， 
服务 器 端 不 仅 创建 要 求 的 资源 ,还 会 缓存 创建 请 求 中 的 ri 参数 ,并 在 创建 响应 中 使 用 。 


3. 创建 响应 


创建 响应 消息 由 服务 器 端 发 送 到 客户 端 。 创 建 响应 消息 将 包含 以 下 参数 。 


(1) fr: 服务 器 端的 唯一 标识 符 。 
(2) to: 客户 端的 唯一 标识 符 。 
CD ris 创建 请 求 中 包括 的 标识 符 。 


OD. cn: 有 关 服 务 器 端 已 创建 的 资源 信息 ,包括 已 创建 资源 的 URI 和 已 创建 的 资源 表示 。 


(5) rs: 创建 操作 的 结果 。 
4.3 检索 


检索 操作 用 来 请 求 现 有 的 资源 状态 或 表示 。 客 户 端 初 





始 化 的 检索 操作 包括 三 个 步骤 ,如 图 4-2 所 示 。 
1. 检索 请 求 








客户 端 服务 器 端 














检索 请 求 消息 由 OCF 客户 端 发 送 到 OCF 服务 器 端 ,以 
请 求 OCF 服务 器 端 上 的 OCF 资源 表示 。 检 索 请 求 消息 将 
包含 以 下 参数 。 

COD fr: OCF 客户 端的 唯一 标识 符 。 

(2) to: OCF 客户 端 指向 资源 的 URI。 

(3) ri: 检索 请 求 的 标识 符 。 

(4) op: 检索 。 





1. 检索 请 求 






2. OCF 服 务 器 端 处 理 请 求 








3. 检索 响应 








' 1 
图 4-2 检索 操作 
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2. OCF 服务 器 端 处 理 请 求 
在 收 到 检索 请 求 之 后 ,OCF 服务 器 端 会 验证 发 送 请 求 的 OCF 客户 端 是 否 具 有 获取 所 需 资源 的 权 


限 , 以 及 资源 的 有 关 属 性 是 否 可 读 。OCF 客户 端 还 会 缓存 检索 请 求 中 的 ri 参数 ,并 在 检索 回复 中 使 用 。 


3. 检索 响应 

检索 响应 消息 由 OCF 服务 器 端 发 送 到 OCF 客户 端 。 检 索 响 应 消息 将 包含 以 下 参数 。 
(1) fr: OCF 服务 器 端的 唯一 标识 符 。 

(2) to: OCF 客户 端的 唯一 标识 符 。 

(3) ri: 检索 请 求 中 包括 的 标识 符 。 

(4) en: OCF 客户 端 请 求 的 资源 信息 ,应 包括 检索 请 求 指向 资源 URL 

(5) rs; 检索 操作 的 结果 。 


4.4 更 新 


更 新 操作 用 来 请 求 替 换 部 分 或 全 部 OCF 资源 的 信息 。OCF 客户 端 初始 化 的 更 新 操作 包括 三 个 步 


又 ,如 图 4-3 所 示 。 


请 求 更 新 OCF 服务 器 端 上 的 OCF 资源 信息 。 更 新 请 求 消息 


1. 更 新 请 求 客户 端 服务 器 端 


更 新 请 求 消息 由 OCF 客户 端 发 送 到 OCF 服务 器 端 ,以 Lan 


将 包含 以 下 参数 。 ER 
(1) fr: OCF 客户 端的 唯一 标识 符 。 E 


m. 








(2) to: OCF 客户 端 指向 需要 更 新 信息 的 资源 URI。 








3. 更 新 响应 
(3) ri; 更 新 请 求 的 标识 符 。 
(4) op: 更 新 。 1 1 
(5) en; 信息 ,包括 目标 资源 上 需要 更 新 的 资源 属性 。 
2. OCF 服务 器 端 处 理 请 求 ES URGET, 


在 收 到 更 新 请 求 之 后 ,OCF 服务 器 端 会 验证 发 送 请 求 的 OCF 客户 端 是 否 具 有 更 新 有 关 资 源 的 权 
如 果 有 ,OCF 客户 端 就 会 根据 更 新 请 求 消息 中 cn 参数 的 值 来 更 新 目标 资源 的 信息 。OCF 客户 端 


还 会 缓存 更 新 请 求 中 的 ri 参数 ,并 在 更 新 响应 中 使 用 。 


3. 更 新 响应 

更 新 响应 消息 由 OCF 服务 器 端 发 送 到 OCF 客户 端 ,更 新 响应 消息 将 包含 以 下 参数 。 
(1) fr: OCF 服务 器 端的 唯一 标识 符 。 

(2) to: OCF 客户 端的 唯一 标识 符 。 

(3) ri; 更 新 请 求 中 包括 的 标识 符 。 

(4) rs: 更 新 操作 的 结果 。 


4.5 ME 


删除 操作 用 来 请 求 删除 部 分 或 全 部 OCF 资源 的 信息 。OCF 客户 端 初始 化 的 删除 操作 包括 三 个 步 


又 ,如 图 4-4 所 示 。 
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客户 端 服务 器 端 
1. 删除 请 求 
2.OCF 服 务 器 端 处 理 请 求 
3. 删除 响应 
Y 1 
图 4-4 删除 操作 


1. 删除 请 求 

删除 请 求 消息 由 OCF 客户 端 发 送 到 OCF 服务 器 端 ,以 删除 OCF 服务 器 端 上 的 OCF 资源 。 删 除 
请 求 消息 将 包含 以 下 参数 。 

A) fr; OCF 客户 端的 唯一 标识 符 。 

(2) to: OCF 客户 端 指向 需要 删除 的 资源 URI。 

(3) ri: 删除 请 求 的 标识 符 。 

(4) op: 删除 。 

2. OCF 服务 器 端 处 理 请 求 

在 收 到 删除 请 求 之 后 ,OCF 服务 器 端 会 验证 发 送 请 求 的 客户 端 是 否 具有 删除 有 关 资 源 的 权限 ,以 
及 相关 资源 是 否 存在 。 如 果 验 证 通过 ,OCF 客户 端 就 会 删除 请 求 资 源 以 及 所 有 相关 的 信息 。OCF 客户 
端 还 会 缓存 删除 请 求 中 的 ri 参数 ,并 在 删除 响应 中 使 用 。 

3. 删除 响应 

删除 响应 消息 由 OCF 服务 器 端 发 送 到 OCF 客户 端 。 删 除 响应 消息 将 包含 以 下 参数 。 

(1) fr; OCF 服务 器 端的 唯一 标识 符 。 

(2) to; OCF 客户 端的 唯一 标识 符 。 

(3) ri: 删除 请 求 中 包括 的 标识 符 。 

(4) rs: 删除 操作 的 结果 。 


4.6 通知 


通知 操作 用 来 请 求 状 态 改变 的 异步 通知 ,使 用 通知 响应 信息 。 通 知 消息 由 OCF 服务 器 端 发 送 到 
OCF 客户 端 ,以 通过 OCF 客户 端 上 的 URL 告知 OCF 客户 端 有 状态 改变 。 通 知 响应 消息 将 包含 以 下 
参数 。 

CD. fr: OCF 服务 器 端的 唯一 标识 符 。 

(2) to: 需要 通知 消息 OCF 目标 资源 的 URI。 

G) ri; 通知 请 求 中 包括 的 标识 符 。 

(4) op: 通知 。 

(5) cn: 更 新 后 的 资源 状态 。 


ON 网 络 连接 及 终端 发 现 


CHAPTER 5 








OCF 所 处 的 物 联 网 环境 是 由 异 构 化 的 系统 组 成 的 。 由 于 这 些 系统 通常 被 定制 成 处 理 专用 需求 的 
系统 ,所 以 它们 都 是 由 非常 多 样 的 产品 和 服务 组 成 的 。 这 些 产品 的 范围 很 广 , 既 涉及 有 限 的 ` 只 能 依靠 
电池 运行 的 设备 ,也 涉及 用 户 可 以 从 市 场 上 购买 到 的 日 常 使 用 的 科技 设备 。 现 阶段 缺少 并 玻 待 创立 一 
个 全 球 化 的 标准 ,以 使 得 致力 于 研究 OCF 的 不 同 项 目 组 可 以 在 一 个 通用 网 络 标准 下 进行 精简 操作 。 

IETF 发 现 了 市 场 的 变化 并 意识 到 了 IPv4 已 经 不 能 满足 使 用 需求 。 不 只 是 新 的 科技 领域 需要 新 技 
术 的 支持 ,管理 更 多 样 的 设备 .日益 复 杂 的 多 种 子 网 .更 高 的 安全 和 隐私 要 求 也 需要 一 系列 新 技术 标准 
的 出 现 。 认 识 到 物理 层 / 数 据 链 路 层 的 存在 需求 后 ,IETF 建立 了 专门 的 工作 组 来 精简 、 提 炼 各 种 现 有 
的 网 络 层 技术 。 根 据 这 些 市 场 的 现实 情况 .这 个 规范 也 意味 着 可 以 充分 利用 现 有 的 无 线 网 (如 蓝牙 、 
WiFi 或 802. 15. 4), 并 集中 研究 网 络 层 和 由 IETF 所 产生 的 相关 协议 。 


5.1 网 络 连接 架构 


IPv4 中 心 网 络 已 经 发 展 到 支持 复杂 的 拓扑 结构 ,其 部 署 主要 由 单一 的 互联 网 服务 提供 商 作 为 单一 
的 网 络 提供 。 而 常 出 现 于 家 居住 宅 的 更 复杂 的 网 络 拓扑 ,大 多 是 通过 收购 更 多 的 家 庭 网 络 设备 实现 的 ， 
这 依赖 于 技术 的 支持 ,如 私有 网 络 地 址 转换 等 。 这 些 技术 在 搭建 和 设置 时 需要 专业 人 员 的 帮助 ,并 应 避 
免 在 家 庭 网 络 中 使 用 ,因为 它们 经 常 导致 路 由 结构 、 命 名 和 发 现 等 服务 的 故障 。 

多 段 生 态 系统 的 OCF 地 址 ,不 仅 会 引发 新 设备 和 有 关 路 由 器 的 激增 ,同时 也 会 增加 那些 引入 额外 
边缘 路 由 器 的 新 服务 。 所 有 这 些 新 的 要 求 都 需要 先进 的 系统 架构 ,以 解决 复杂 的 网 络 拓扑 ,如 图 5-1 所 
示 , 深 色 的 部 分 表示 非 OCF 部 分 。 

图 5-1 中 所 示 的 设备 承担 以 下 几 个 角色 之 一 。 

CD IETF RFC 6434 CE 路 由 器 (用 户 端 边缘 路 由 器 ) 中 定义 的 IPv6 节点 ,IPv6 路 由 器 。 

(2) IPv6 主机 : 在 IETF RFC 7084 中 具体 定义 。 

(3) 6LN(6LoWPAN 节点 )、6LR(6LoWPAN 路 由 器 )、6LBR(6LoWPAN 边界 路 由 器 ), 在 IETF 
RFC 6775 中 定义 。 

(4) IPv6 转换 器 ,用 以 在 IPv6 网 络 、 非 IPv6 网 络 间 翻译 和 路 由 相关 的 设备 ,图 5-1 中 的 网 关 就 是 
一 个 转换 器 的 实例 。 

CO 约束 节点 : 由 于 受 约束 的 环境 (有 限 的 处 理 能 力 、 存 储 器 , 非 易 失 性 存储 介质 和 传输 容量 ) 需 要 IP 
网 络 层 下 的 特别 适 配 层 ,并 需要 专门 的 路 由 协议 的 节点 。 例 如 ,在 低 功率 下 传输 的 设备 、IEEE 802. 14. 5、 
ITU G9959 、 低 功 耗 蓝牙 和 NFC 等 。 
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图 5-1 高 层 网 络 和 连接 架构 


5.2 IPv6 网 络 层 需 求 


预测 表明 , 数 百 亿 新 的 物 联 网 终端 及 相关 服务 将 在 未 来 几 年 内 联机 。 这 些 端 点 功能 范围 将 从 使 用 
电池 供电 的 具有 有 限 的 计算 、 存 储 和 带宽 的 节点 跨越 到 拥有 更 丰富 的 资源 ,通过 以 太 网 和 WiFi 链 路 工 
作 的 器 件 。 

AY 30 年 前 部 署 的 互联 网 IPv4 已 经 成 熟 ,并 支持 多 种 应 用 ,如 Web 浏览 .电子 邮件 .语音 、 视 频 和 
关键 系统 的 监测 和 控制 。 但 是 ,IPv4 的 能 力 濒临 用 尽 , 并 不 仅仅 只 是 可 用 地 址 空间 已 被 消耗 的 程度 。 

IETF 开发 IPv4 的 继任 者 IPv6。OCF 建议 在 网 络 层 使 用 IPv6。 其 原因 如 下 。 

(1) 更 大 的 地 址 空间 ,大 大 减少 网 络 接 入 转换 的 需要 。 

(2) 更 灵活 的 地 址 结构 ,每 个 结构 可 以 使 用 多 个 地 址 和 类 型 .如 本 地 链 路 .ULA、GUA 和 各 种 范围 
的 组 播 地 址 等 ; 更 好 地 支持 多 归属 网 络 . 拥 有 更 好 的 重新 编号 能 力 等 。 

(3) 更 强大 的 自动 配置 功能 ,如 DHCPv6,SLAAC 和 路 由 器 发 现 等 。 在 技术 约束 节点 上 实现 IP 连 
接 的 操作 也 是 基于 IPv6 的 。 

(4) 所 有 主流 的 消费 者 操作 系统 ,如 iOS, Android, Windows 和 Linux 都 已 经 支持 IPv6。 全 球 各 地 
的 主要 服务 提供 商 也 都 已 经 部 署 IPv6 。 

为 了 保证 网 络 层 服务 从 节点 到 节点 的 互 操 作 性 ,在 所 有 节点 上 强制 统一 公共 网 络 层 协议 是 至 关 重 
要 的 。 该 协议 应 使 网 络 能 够 成 为 安全 的 、 可 管理 的 、 可 扩展 的 网 络 , 并 包括 约束 节点 和 自 组 网 状 节点 。 
OCF 建议 使 用 IPv6 作为 公共 的 网 络 层 协议 ,以 保证 所 有 OCF 设备 间 的 互 操作 性 。 本 章 将 关注 IPv6 € 
机 、 约 东 主 机 和 路 由 器 的 互 操 作 需 求 。 

IPv6 节点 应 支持 IPv6 。 若 一 个 节点 支持 IPv6, 则 应 该 遵守 以 下 在 本 地 网 络 中 通信 的 要 求 。 

(1) 应 支持 IETF RFC 2460*IPv6 规范 ?和 类 似 IETF RFC 6434"*IPv6 节点 要 求 ” 的 相关 更 新 。 

(2) 应 支持 IETF RFC 4291*IPv6 寻 址 体系 结构 ”和 类 似 IETF RFC 6434*IPv6 节点 要 求 ” 的 相关 
更 新 。 

(3) 应 支持 IETF RFC 4861*IPv6 Bit RIL” Al IETF RFC 6434“IPv6 节点 要 求 ”。 
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(4) 应 支持 IETF RFC 1981* 路 径 MTU 发 现 ” 和 IETF RFC 6434*IPv6 节点 要 求 ”的 相关 更 新 。 
(5) 应 支持 IETF RFC 1981“ 唯 一 本 地 IPv6 单 播 地 址 ”和 相关 更 新 。 

(6) 应 当 支 持 IETF RFC 3810* 组 播 监听 发 现 版 本 2? 和 相关 更 新 。 

(7) IPv6 路 由 器 IPv6 主机 应 支持 所 有 的 节点 需求 。 


5.3 终端 定义 


终端 的 具体 定义 取决 于 正在 使 用 的 传输 协议 。 对 于 通过 IPv6 的 UDP 上 的 CoAP 示例 ,终端 由 
IPv6 地 址 和 UDP 端口 号 标识 。 

每 个 OCF 设备 至 少 应 与 一 个 可 以 与 其 交换 请 求 和 响应 消息 的 终端 相关 联 。 当 消息 发 送 到 终端 时 ， 
它 将 被 传递 到 与 终端 相关 联 的 OCF 设备 。 当 请 求 消息 传递 到 终端 时 ,路径 组 件 就 有 足够 的 能 力 找到 目 
标 资源 。 

OCF 设备 能 与 多 个 终端 相关 联 。 例 如 ,一 个 OCF 设备 可 以 拥有 几 个 IP 地 址 或 者 端口 号 , 它 也 可 
以 同时 支持 HTTP 协议 和 CoAP 协议 。 

另外 , 当 有 一 种 方法 能 去 清楚 地 用 URI 指定 目标 资源 时 ,一 个 终端 也 可 以 被 多 个 OCF 设备 共享 。 
例如 , 当 一 个 CoAP 服务 器 端 对 托管 于 自身 的 资源 使 用 了 唯一 不 同 路 径 ,那么 它 就 可 以 被 多 个 OCF 设 
备 共享 。 然 而 ,这 对 于 OCF 1.0 和 OCF 1. 1 是 不 可 能 的 ,因为 一 些 预 定义 URI( 如 “oic/d”) 对 于 某 些 资 
源 是 强制 性 的 。 

终端 由 终端 信息 来 表示 。 其 中 ,终端 信息 是 由 “ep” 和 *pri" 两 个 键 值 对 组 成 。 

1. "ep" 

“ep" 表 示 传 输 协 议和 终端 定位 器 ,指定 如 下 内 容 。 

CD 传输 协议 (例如 CoAP + UDP 十 IPv6) 的 组 合 , 可 以 与 RESTful 操作 ( 即 CRUDN) 交 换 请 求 
和 响应 消息 。 传 输 协议 套件 应 由 IANA 注册 方案 表示 ,还 允许 供应 商 或 OCF 定义 的 方案 (如 *org. ocf 
.foo” 或 “com. samsung. bar”) 。 

(2) 终端 定位 器 ,通过 该 地 址 (如 IPv6 地 址 十 端口 号 ) 可 以 将 消息 发 送 到 终端 ,然后 将 相关 联 的 
OCF 设备 发 送 到 该 地 址 。“*CoAP”CoAPS”CoAP 十 TCP”CoAPS 十 TCP”™HTTP” 和 “HTTPS” 的 终 
端 定位 器 应 指定 为 “IP 地 址 十 端口 号 ”。 不 应 使 用 临时 地 址 ,因为 终端 定位 器 是 为 了 接收 传人 的 会 话 ， 
而 临时 地 址 用 于 启动 传 出 会 话 。 此 外 , 它 包含 在 */oic/res” 中 可 能 会 导致 隐私 问题 。 

(3) “ep” 应 具有 一 个 如 方案 组 件 所 说 明 的 传输 协议 的 URI。 例 如 ."ep":"coap://[fe80: :bld6] 
31", 

各 传输 协议 中 的 "ep" 值 如 表 5-1 所 示 。 

表 5-1 各 传输 协议 中 的 “ep” 值 























传输 协议 3 R 终端 定位 器 “ep" 值 示例 
CoAP+UDP+IP CoAP IP 地 址 十 端口 号 coap://[fe80::b1d6]:1111 
CoAPS+UDP+IP CoAPS IP 地 址 十 端口 号 coaps://[fe80::bld6]:1122 
CoAP+TCP+IP CoAP+TCP IP 地 址 十 端口 号 coap 十 tcp://[2001:db8:a: :123]:2222 
CoAPS+TCP+IP CoAPS+TCP IP 地 址 十 端口 号 coaps 十 tcp://[2001:db8:a::123]:2233 
HTTP+TCP+IP HTTP IP 地 址 十 端口 号 http://[2001:db8:a::123]:1111 
HTTPS+TCP+IP HTTPS IP 地 址 十 端口 号 https://[2001:db8:a: :123]:1122 
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2. "pri" 

当 有 多 个 终端 的 时 候 ,“pri" 用 于 指出 它们 之 间 的 优先 级 .“pri" 应 当 由 一 个 正 整数 来 表示 (例如 ， 
"pri" :2) ,而 且 值 越 小 ,优先 级 越 高 。 默 认 的 “pri" 值 是 1. 例 如 , 当 *pri" 没 有 表示 出 来 时 , 它 应 当 等 于 1。 

3.“eps” 参 数 中 的 终端 信息 

为 了 传输 终端 信息 ,在 第 3 章 中 定义 了 一 个 新 的 链接 参数 “eps”。“eps” 中 以 项 目 数 作 为 其 值 ,每 个 
项 目 以 “ep” 和 “pri” 两 个 键 值 对 来 表示 终端 信息 ,其 中 ,“ep” 是 必需 的 ,“pri" 是 可 选 的。 具有 “eps” 的 链 
接 如 下 。 

{ 

"anchor": "ocf://light_device_id", 

"href": "/nyLightSwitch", 

"rt": ["oic. r. switch. binary"], 

"if": ["oic.if.a", "oic. if.baseline"], 

p": ("bn": 3}, 

"eps": [{"ep": "coap://[fe80: :b1d6]:1111", "pri": 2), ("ep": 

"coaps://[fe80: :b1d6]:1122"}] 

) 


Hp anchor" 4€ OCF 主机 设备 ,“href” 代 表 目 标 资源 ,“eps” 代 表 目 标 资源 的 两 个 终端 。 如 果 一 
个 目标 资源 要 求 一 个 安全 连接 (如 “coaps”) ,在 OCF 1. 0 的 有 效 载荷 中 “eps” 参 数 应 该 被 用 于 指出 必要 
的 信息 (如 端口 号 ) ,因为 *sec” 和 “port” 只 能 在 OCF 1. 1 的 有 效 载 荷 中 使 用 。 


5.4 终端 发 现 


终端 发 现 被 定义 为 一 个 客户 端 向 一 个 OCF 设备 或 者 资源 请 求 终端 信息 的 一 个 过 程 。 
1. 隐 式 发 现 
如 果 设 备 是 CoAP 消息 的 源 ( 如 */oic/res” 响 应 ), 则 可 以 通过 组 合 源 IP 地 址 和 端口 号 形成 设备 的 
终端 定位 器 。 根 据 CoAP 方案 和 默认 的 “pri" 值 ,可 以 构建 设备 的 终端 信息 。 
换 句 话说 ,具有 CoAP 的 “/oic/res” 响 应 消息 可 以 隐 含 携带 响应 设备 的 终端 信息 , 反 过 来 又 可 以 使 
用 相同 的 CoAP 传输 协议 访问 所 有 在 主机 上 托管 的 资源 。 
2. 使 用 “/oic/res" 响 应 进行 显 式 发 现 
终端 信息 可 以 使 用 “/oic/res” 中 链接 的 eps” 参数 明确 指出 。“/oic/res” 响 应 可 以 隐 式 表示 由 响应 
设备 托管 目标 资源 的 终端 信息 。 但 是 ,“/oic/res” 可 能 会 暴露 属于 另 一 个 设备 的 目标 资源 。 当 链接 目标 
资源 的 端点 不 能 被 隐 式 推断 时 ,应 包含 "eps” 参 数 提供 客户 端 可 以 访问 目标 资源 的 显 式 终端 信息 。 
这 种 方法 适用 于 资源 目录 或 桥接 设备 的 *“/oic/res”, 该 设备 通常 携带 另 一 台 设 备 所 承载 的 资源 链 
接 。 下 面 是 链接 中 “eps” 参 数 的 “/oic/res” 响 应 。 
[ 
{ 
"anchor" : "ocf://e61c3e6b — 9c54 — 4b81 — 8ce5 — £9039c1d04d9", 
"href": "/oic/res", 
"rel": "self", 
"rt": ["oic.wk.res"], 
"if": ["oic. if.11", "oic. if.baseline"], 


60 «|| OCF 技 术 原理 


及 物 联网 程序 开发 指南 








"bn": 3}, 
: [("ep": "coap://[2001 :db8: 
(" ep": "coaps://[2001:db8: 





1d4]:55555"), 
b1d4]:11111")] 








"anchor" : "ocf ://e61c3e6b - 9c54 — 4b81 - 8ce5 — £9039c1d04d9", 

"href": "/oic/d", 

"rt": ["oic.wk.d", "oic.d.bridge"], 

"if": ["oic. if. r", "oic. if. baseline"], 

p": ("bn": 3}, 

"eps": [ ("ep": "coap://[2001 :db8 
("ep" : "coaps://[2001:db8: 





bid4]:55555"}, 
::bld4]:11111"}] 






anchor": "ocf://e61c3e6b — 9c54 — 4b81 - 8ce5 — £9039c1d04d9", 
"href": "/oic/p", 

["oic. wk. p"], 

["oic.if.r", "oic. if. baseline" ], 

"bn": 3}, 

"eps": [{"ep": "coaps://[2001:db8:a: :b1d4]:11111")] 





"anchor": "ocf ://e61c3e6b — 9c54 — 4b81 - 8ce5 - £9039c1d04d9", 
"href": "/mySecureMode", 

"rt": ["oic. r. securemode"], 

"if": ["oic. if. rw", "oic. if. baseline" ], 

"p": {"bm": 3), 

"eps": [{"ep": "coaps://[2001:db8:a: :b1d4]:11111")] 


"anchor" : "ocf://e61c3e6b - 9c54 — 4b81 - 8ce5 - £9039c1d04d9" , 
"href" : "/oic/sec/doxn" , 

"rt": ["oic.r.doxn"], 

"if": ["oic. if. baseline"], 

"Pa": 1), 

: [(" ep": "coap://[2001:db8 
(" ep" : "coaps://[2001:db8: 





1da4]:55555"], 
bid4]:11111"])] 








"anchor" : "ocf://e61c3e6b - 9c54 — 4b81 - 8ce5 — £9039c1d04d9", 
"href": "/oic/sec/pstat", 

"rt": ["oic. r. pstat"], 

"if": ["oic. if. baseline" ], 

"p": {"bm": 1), 

"eps": [{"ep": "coaps://[2001:db8:a: :b1d4]:11111")] 


"anchor": "ocf://e61c3e6b — 9c54 - 4b81 — 8ce5 — £9039c1d04d9" , 
"href": "/oic/sec/cred", 

"rt": ["oic.r.cred"], 

"if": ["oic. if. baseline"], 

{"bm": 1}, 

: [{"ep": "coaps: //[2001:db8:a: :b1d4]:11111"]] 
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"anchor": "ocf://e61c3e6b - 9c54 — 4b81 - 8ce5 — f9039c1d04d9", 
"href": "/oic/sec/acl2", 

"rt": ["oic. r.acl2"], 

"if": ["oic. if. baseline" ], 

"p": {"bm": 1), 

"eps": [("ep": "coaps://[2001:db8:a: :b1d4]:11111")] 


"anchor": "ocf://e61c3e6b — 9c54 — 4b81 - 8ce5 - £9039c1d04d9", 
"href": "/nyIntrospection", 

"rt": ["oic. wk, introspection"], 

["oic. if.r", "oic. if. baseline"], 

: ("bn": 3}, 

"eps": [{"ep": "coaps://[2001:db8:a: :b1d4]:11111")] 





"anchor": "ocf ://dc70373c - 1e8d - 4£b3 - 962e - 017eaa863989", 

"href": "/oic/res", 

"rt": ["oic. wk. res"], 

"if": ["oic. if. 11", "oic. if. baseline"], 

"bm": 3), 

eps": [("ep": "coap://[2001:db8: 
("ep" : "coaps://[2001 :db8: 





: :bld4]:66666"], 
b1d4]:22222"]] 






"anchor" : "ocf://dc70373c - 1e8d - 4£b3 - 962e - 017eaa863989", 

"href": "/oic/d", 

"rt": ["oic.wk.d", "oic.d. light", "oic.d.virtual"], 

"if": ["oic. if. r", "oic. if. baseline"], 

tf^" 3}, 

"eps": [ ("ep": "coap://[2001 :db8 
{"ep": "coaps://[2001:db8: 





bid4] :66666"}, 
: :b1d4]:22222"]] 






"anchor": "ocf://dc70373c — 1e8d - 4£b3 - 962e - 017eaa863989", 
"href": "/oic/p", 

"rt": ["oic. wk. p"], 

"if": ["oic. if.r", "oic.if.baseline"], 

"p": ("bn": 3), 

"eps": [ ("ep": "coaps://[2001 :db8:a: :b1d4] :22222"}] 





"anchor": "ocf://dc70373c — 1e8d - 4£b3 - 962e - 017eaa863989", 
"href": "/myLight", 

"rt": ["oic. r. switch. binary" ], 

"if": ["oic. if.a", "oic. if. baseline" ], 

: ("ba^ : 3}, 

"eps": [{"ep": "coaps://[2001:db8:a: :b1d4]:22222"}] 





"anchor": "ocf://dc70373c — 1e8d — 4£b3 - 962e — 017622863989", 
"href": " /oic/sec/doxn" , 
"rt": ["oic.r.doxn"], 
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"if": ["oic. if. baseline"], 

"p": ("ba": 1), 

"eps": [{"ep": "coap://[2001:db8:a::b1d4]:66666"], 
{"ep": "coaps://[2001:db8:a: :b1d4] :22222"}] 























h 
t 
"anchor": "ocf://dc70373c — 1e8d - 4£b3 - 962e - 017eaa863989" , 
"href": "/oic/sec/pstat", 
"rt": ["oic.r. pstat"], 
if": ["oic. if. baseline"], 
"ba": 1), 
: [(" ep": "coaps://[2001:db8:a: :b1d4]:22222"}] 
Lh 
t 
"ocf : //dc70373c - 1e8d - 4£b3 - 962e — 017eaa863989" , 
"href": "/oic/sec/cred", 
["oic. r. cred"], 
["oic. if. baseline" ], 
"bn": 1}, 
"eps": [("ep": "coaps://[2001:db8:a: :b1d4] :22222"]] 
) 
t 
"anchor": "ocf://dc70373c - 1e8d - 4£b3 - 962e - 017eaa863989", 
"href" : "/oic/sec/acl2", 
"rt": ["oic.r.ac12"], 
"if": ["oic. if. baseline"], 
"p": ("bu : 1), 
"eps": [("ep": "coaps://[2001:db8:a: :b1d4] :22222")] 
L 
{ 
"anchor" : "ocf://dc70373c - 1e8d - 4£b3 - 962e - 017eaa863989", 
"href": "/nyLightIntrospection", 
"rt": ["oic. wk. introspection"], 
"if": ["oic. if. r", "oic. if. baseline"], 
"pa": 3), 
: [(" ep": "coaps://[2001:db8:a: :b1d4]:22222")] 
Lh 
{ 
"anchor" : "ocf://88b7c7£0 — 4b51 - 4e0a - 9faa - cfb439fd7£49", 
"href": "/oic/res", 
"rt": ["oic. wk. res"], 
"if": ["oic. if. 11", "oic. if. baseline" ], 
“p's ("ra* a} 
"eps": [{"ep": "coap://[2001:db8:a: :b1d4] 77777"), 
("ep" : "coaps://[2001:db8:a: :bid4]:33333"}] 
h 
t 


"anchor" : "ocf://88b7c7£0 — 4b51 — 4e0a — 9faa — cfb439fd7f49", 
"href": "/oic/d", 
"rt": ["oic.wk.d", "oic.d.fan", "oic.d.virtual"], 


if": ["oic. if.r", "oic. if.baseline"], 

{"bm": 3}, 

: [{"ep": "coap://[ 2001: db8 
{"ep": "coaps://[2001 :db8: 
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"anchor": "ocf://88b7c7f0 — 4b51 - 4e0a — 9faa - cfb439fd7f49", 
"href": "/oic/p", 

"rt": ["oic.wk.p"], 

"if": ["oic. if. r", "oic. if. baseline"], 

"p^: {"bm": 3), 

"eps": [("ep": "coaps://[2001:db8:a: :b1d4] :33333"]] 





"anchor": "ocf://88b7c7f0 - 4b51 — 4e0a - 9faa - cfb439fd7£49", 
"href": "/myFan", 

["oic. r. switch. binary"], 

: ["oic. if.a", "oic. if. baseline" ], 

"bm": 3}, 

: [{"ep": "coaps://[2001 :db8:a: :b1d4] :33333")] 





"anchor" : "ocf://88b7c7£0 - 4b51 - 4e0a — 9faa - cfb439fd7f49", 
"href": "/oic/sec/doxn" , 
"rt": ["oic. r.doxn"], 
"if": ["oic. if. baseline"], 
": {"bm": 1}, 
"eps": [{"ep": "coap://[2001:db8:a: :b1d4]:77777"}, 
{"ep": "coaps://[2001:db8:a: :b1d4] :33333"}] 








anchor" : "ocf://88b7c7f0 — 4b51 - 4e0a — 9faa — cfb439fd7£49", 
"href": "/oic/sec/pstat", 

["oic.r.pstat"], 

"if": ["oic. if. baseline"], 

"bn": 1), 

: [{"ep": "coaps://[2001 :db8:a: :b1d4] :33333"]] 








"anchor": "ocf://88b7c7£0 — 4b51 - 4e0a - 9faa - cfb439fd7£49" , 
"href": "/oic/sec/cred" , 

"rt": ["oic. r.cred"], 

"if": ["oic. if. baseline"], 

"p": ("bn": 1), 

"eps": [{"ep": "coaps://[2001:db8:a: :b1d4]:33333")] 





"anchor": "ocf://88b7c7£0 - 4b51 - 4e0a ~ 9faa - cfb439£d7£49", 
"href": "/oic/sec/acl2", 

"rt": ["oic.r.acl2"], 

"if": ["oic. if. baseline" ], 

"p": ("bu": 1}, 

"eps": [ ("ep": "coaps://[2001:db8:a: :b1d4]:33333"]] 





"anchor": "ocf://88b7c7£0 — 4b51 — 4e0a — 9faa — cfb439fd7f49", 
"href": "/myFanIntrospection", 
"rt": ["oic. wk. introspection" ], 
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"if": ["oic. if. r", "oic. if.baseline"], 
"p": ("bu^: 3), 
"eps": [("ep": "coaps://[2001:db8:a: :b1d4] :33333"}] 





5.5 基于 CoAP 的 终端 发 现 


本 节 主 要 是 一 些 基于 CoAP 终端 发 现 的 总 结 描述 。 

CD 所 有 正在 广播 和 发 布 的 设备 都 应 加 入 “所 有 CoAP 节点 ”多 播 分 组 ,如 IPv6 中 的 FFOX: FD 或 
监听 端口 5683。 

(2) 需要 发 现 资源 的 OCF 客户 端 应 首先 加 入 “所 有 CoAP 节点 ”多 播 分 组 。 

(3) OCF 客户 端 应 发 送 一 个 发 现 请 求 (GET 请 求 ) 给 多 播 分 组 "所 有 CoAP 节点 ”和 端口 5683, 请 求 
中 的 URI 应 为 /oic/res。 

(4) 车 OCF 客户 端正 处 于 发 现 指定 资源 类 型 的 过 程 中 . 则 它 应 使 用 带 有 键 *rt” 的 问 询 机 制 ,“rt” 的 
值 应 为 需要 发 现 的 目标 。 

(5) 如 果 问 询 请 求 中 不 带 有 ”rt" 键 , 则 所 有 的 OCF 设备 都 应 回复 这 个 请 求 。 

(6) 处 理 多 播 请 求 的 注意 事项 应 与 在 IETF RFC 7252 规范 和 IETF RFC 6690 规范 中 定义 的 一 样 。 
收 到 请 求 的 OCF 设备 应 该 使 用 CBOR 作为 负载 (内 容 ) 编 码 方式 进行 回复 。OCF 设备 应 使 用 CBOR 作 
为 额外 的 多 播发 现 负载 (内 容 ) 编 码 方式 。OCF 设备 也 应 该 使 用 CBOR 作为 负载 (内 容 ) 编 码 方式 回复 
一 个 已 收 到 支持 CBOR 的 多 播发 现 消息 。 在 之 后 的 版 本 中 ,可 以 被 其 他 方式 使 用 (如 JSON .XMLVEXI 
等 )。 


$65 OCF 的 功能 交互 





CHAPTER 6 





功能 交互 是 指 客户 端 和 服务 器 端 之 间 相 互信 息 交 换 的 过 程 。 功 能 交互 使 用 CRUDN 消息 ,包括 发 


现 、 通 知 和 设备 管理 。 这 些 功能 需要 支持 表 6-1 中 定义 的 核心 资源 。 
表 6-1 核心 资源 列表 



































预定 义 的 URI 资源 类 型 标题 相关 的 功能 交互 要 求 
/oic/res 默认 发 现 强制 
/oic/p 平台 RR 强制 
/oic/d 设备 发 现 强制 
/oic/rts 资源 类 型 发 现 条 件 
/oic/ifs 接口 发 现 条 件 
/oic/con 配置 设备 管理 条 件 
/oic/mon 监测 设备 管理 条 件 
/oic/mnt 维护 设备 管理 条 件 

6.1 服务 开通 


在 OCF 框架 中 服务 开通 包括 两 个 不 同 的 过 程 : On-Boarding 和 配置 。On-Boarding 是 向 加 入 OCF 


网 络 的 设备 传递 所 需 信息 的 过 程 。 当 On-Boarding 过 程 完成 时 ,设备 具有 
必要 的 信息 并 且 能 够 加 入 OCF 网 络 ( 图 6-1 中 的 状态 #1)。 配 置 是 向 设备 
提供 所 需 信息 以 访问 OCF 服务 的 过 程 。 在 配置 过 程 结束 时 ,设备 具有 所 
有 必要 的 信息 ,并 且 能 够 访问 OCF 服务 (图 6-1 中 的 状态 #2)。 

1. #1 On-Boarding 

OCF 框架 适用 于 具有 不 同 能 力 的 多 种 类 型 设备 ,包括 丰富 的 用 户 接 
口 设备 ,这 种 设备 可 以 从 用 户 处 接收 输入 ,如 智能 电话 ; 还 包括 没有 接收 
用 户 输入 装置 的 设备 ,如 传感器 。 另 外 ,设备 可 以 支持 不 同 的 通信 和 连接 
技术 ,如 蓝牙 和 WiFi 等 ,不 同 的 通信 和 连接 技术 提供 特定 的 登录 机 制 。 





服务 开通 机 制 





打开 





i 


On-Boarding 





状态 机 





i 


配置 





状态 各 














6-1 服务 开通 状态 改变 


由 于 设备 能 力 的 差异 和 多 样 性 , OCF 1. 1 规范 不 要 求 特定 的 On-Boarding 过 程 ,而 是 在 完成 


On-Boarding 过 程 时 指定 设备 的 状态 。 


作为 On-Boarding 过 程 的 一 部 分 ,设备 会 获取 详细 信息 和 所 需 的 参数 值 (如 WiFi 的 SSID 以 及 认证 
WEP) ,以 便 能 够 连接 到 网 络 , 从 而 在 On-Boarding 过 程 结束 时 成 功 建立 到 网 络 的 连接 。OCF 规范 的 后 
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续 版 本 可 以 指定 跨 不 同 通信 和 连接 技术 的 On-Barding 的 通用 过 程 。 

2. $28 € 

一 且 设 备 成 功 连接 到 OCF 网 络 , 它 需要 额外 的 配置 信息 来 访问 OCF 或 订阅 OCF 服务 。 所 需 的 信 
息 可 以 包括 地 理 位 置 .时 区 和 安全 要 求 等 。 该 信息 可 以 预先 加 载 在 设备 上 ,或 者 可 以 从 另 一 设备 (如 配 
置 源 ) 上 的 配置 服务 获取 。 关 于 配置 服务 资源 的 信息 ,如 配置 源 的 URI, 被 预先 配置 在 设备 上 。 

配置 信息 也 在 核心 资源 */oic/con” 中 。 当 完成 On-Boarding 过 程 并 且 设备 连接 到 网 络 , 如 果 没 有 预 
加 载 配置 信息 , 则 将 启动 配置 过 程 , 通 过 获取 或 推送 的 交互 ,并 用 当前 配置 的 状态 信息 填充 其 指定 的 配 
置 资源 ,通过 这 一 过 程 设备 获取 相关 配置 信息 。 指 定 的 配置 资源 保持 最 新 的 配置 状态 ,配置 的 更 新 是 通 
过 指定 资源 来 完成 的 。 

如 果 配 置信 息 未 加 载 , 则 设备 将 从 配置 源 检索 它们 。 在 设备 的 生存 期 间 , 客 户 端 可 以 检索 或 更 新 设 
备 的 配置 状态 。 某 些 配置 信息 是 只 读 的 ,可 以 由 配置 源 修改 ,具体 取决 于 */oic/con” 资 源 中 属性 的 访问 
模式 。 

图 6-2 描述 了 设备 从 配置 源 ( 其 可 以 位 于 远程 设备 或 本 地 ) 检 索 其 配置 信息 而 触发 的 交互 。 这 些 相 
互 作用 在 完成 On-Boarding 过 程 后 立即 发 生 ; 设备 可 以 在 生存 期 内 的 任何 时 间 检 索 其 配置 ( 见 图 6-3) 。 
图 6-4 表述 了 当 一 个 设备 的 配置 信息 被 一 个 客户 端 (如 配置 源 ) 更 新 了 的 交互 。 


OCF 客 户 端 
为 OCF 设 备 配置 信息 源 
检索 配置 信息 
































On-Boarding 
步 又 成 功 完成 
1 检索 请 求 -| 
(配置 ) 
2. 检索 响应 
(配置 ) 
普通 配置 资源 
更 新 完毕 

















图 6-2 设备 从 配置 源 检索 其 配置 信息 而 触发 的 交互 


如 果 设 备 支持 配置 , 即 配置 信息 可 以 动态 更 新 , 则 应 支持 核心 资源 */oic/con” 作 为 指定 的 配置 资 
源 ,如 表 6-2 所 示 。 表 6-3 定义 了 “oic. wk. con "资源 类 型 。 

设备 或 平台 可 能 最 初 是 在 引导 中 设置 或 提供 信息 进行 配置 。 此 外 ,根据 变化 的 条 件 或 上 下 文 环境 ， 
设备 和 平台 可 以 由 引导 后 的 外 部 代理 进一步 配置 。 核 心 资源 “/oic/con" 暴 露 可 用 于 配置 更 改 属性 。 

一 个 配置 是 通过 设置 与 该 配置 中 相关 的 全 体 属性 来 确定 的 。 设 置 新 配置 的 结果 由 该 集合 中 特定 属 
性 的 值 确定 。 通 过 “/oic/con" 设 置 新 配置 的 启动 进程 ,可 能 导致 在 其 他 资源 中 产生 副作用 。 


第 6 章 ”OCF 的 功能 交互 || 67 




































































OCF 客 户 端 从 另 OCF 客 户 端 从 另 
-个 OCF 设备 OCF 服 务 器 端 一 个 OCF 设 备 更 OCF HI Hi 
检索 配置 信息 新 配置 信息 
1. 检索 请 求 1. 更 新 请 求 
(配置 ) (配置 ) 
2. 检索 响应 2. 更 新 响应 
(配置 ) (配置 ) 
图 6-3 检索 一 个 设备 的 配置 状态 的 交互 图 6-4 一 个 设备 配置 的 更 新 
表 6-2 配置 资源 
预定 义 的 URI| 资源 类 型 标题 | 资源 类 型 ID(“rt" 值 ) | ”接口 do g 相关 的 功能 交互 
资源 通过 特定 设备 的 可 配置 信 
/oic/con 配置 oic. wk. con oic. if. rw | 息 被 暴露 出 来 ; Hr" /oic/con" 4E 配置 
露 的 资源 属性 在 表 6-3 中 列 出 





表 6-3 "oic. wk. con” 资 源 类 型 定义 






































属性 | 属性 名 | 属性 值 类 型 | 属性 值 规则 | 单位 | 访问 模式 | 是 否 强制 描 £ 
y 终端 用 户 可 配置 的 人 性 化 名 称 ( 例 如 ， 
设备 名 | mn 字符 串 读 写 是 Bob 的 恒温 器 ) 
位 置 loc JSON iE F 在 可 用 时 提供 位 置信 息 
位 置 名 | locn 字符 串 读 写 "5 人 性 化 的 位 置 名 称 , 例 如 客厅 
货币 c 字符 串 读 写 "5 指明 用 于 交易 的 货币 
自由 格式 文本 指示 设备 在 地 理 上 所 处 的 
as 7 SS Lind i 当前 区 域 , 自 由 格式 文本 不 应 以 引号 开头 


6.2 资源 发 现 


作为 发 现 的 一 部 分 ,客户 端 可 以 找到 关于 其 他 OCF 对 等 体 的 适当 信息 。 该 信息 可 以 是 资源 实例 、 
资源 类 型 ,或 者 OCF 对 等 体 期 望 另 一 个 OCF 对 等 体 发 现 的 资源 模型 信息 。 至 少 , 基 于 资源 的 发 现 会 使 
用 以 下 内 容 。 

(1) 应 定义 一 个 启用 发 现 的 资源 ,该 资源 的 表示 应 包含 可 以 被 发 现 的 信息 。 

(2) 能 够 发 现 的 资源 应 是 指定 的 和 事先 已 知 的 ,或 在 引导 区 (如 在 垂直 规范 中 指定 ) ,或 可 以 被 发 现 
的 (例如 使 用 其 他 方法 ) 。 

(3) 包含 发 现 资源 的 设备 应 该 被 标识 。 

(4) 需要 公布 发 现 资源 信息 的 机 制 、 过 程 以 及 启用 发 现 资源 。 
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(5) 需要 发 现 资源 的 接 和 人、 获取 信息 的 机 制 和 过 程 。 在 请 求 中 可 能 会 使 用 一 个 查询 ,以 限制 返回 
HE. 

(6) 发 布 的 范围 。 

(7) 获取 的 范围 。 

(8) 信息 可 见 性 策略 。 

根据 上 面 定义 的 基本 原则 ,框架 定义 了 三 种 基于 资源 的 发 现 机 制 。 

(1) 直接 发 现 , 在 本 地 资源 所 在 的 设备 上 发 布 , 并 通过 对 等 查询 发 现 。 

(2) 间接 发 现 , 在 协助 发 现 的 第 三 方 发 布 .并 且 对 等 实体 针对 资源 发 布 和 执行 发 现 ,以 在 协助 第 三 
方 上 启用 发 现 。 

(3) 广播 发 现 , 用 于 启用 发 现 的 资源 ,发 起 者 是 本 地 的 ,但 是 发 布 发 现 信息 的 设备 是 远程 的 。 


6.2.1 直接 发 现 


一 个 设备 应 该 支持 直接 发 现 , 在 直接 发 现 中 主要 完成 以 下 功能 。 

(1) 提供 信息 的 设备 应 该 托管 用 于 启用 发 现 的 资源 。 

(2) 设备 使 用 本 地 资源 发 布 可 发 现 的 信息 ,以 启用 发 现 ( 即 本 地 范围 )。 

CD 对 此 设备 发 现 信息 感 兴趣 的 客户 端 应 直接 向 资源 发 出 检索 请 求 . 该 请 求 可 以 作为 单 播 或 多 播 。 
请 求 可 以 是 通用 的 ,或 者 通过 在 请 求 中 使 用 适当 的 查询 来 限定 或 限制 。 

(4) 接收 请 求 的 服务 器 端 设备 应 当 将 发 现 信息 的 响应 直接 发 送 回 请 求 的 客户 端 设备 。 

(5) 请 求 中 包含 的 信息 由 一 些 策略 来 决定 ,这 些 策 略 是 为 在 响应 设备 上 本 地 发 现 资源 而 设置 的 。 


6.2.2 间接 发 现 / 基 于 资源 目录 


资源 的 间接 发 现 也 称 为 基于 资源 目录 的 发 现 ,在 间接 发 现 中 ,有 关 要 发 现 资源 的 信息 托管 在 非 资源 
所 在 的 服务 器 端 上 。 在 间接 发 现 中 主要 完成 以 下 功能 。 

(1) 被 发 现 的 资源 既 不 在 发 起 发 现 客户 端的 设备 上 ,也 不 在 提供 或 发 布 要 发 现 信息 的 设备 上 。 该 
设备 可 以 使 用 相同 的 资源 来 为 多 个 代理 提供 发 现 , 也 可 以 为 多 个 代理 提供 发 现 信息 。 

(2) 被 发 现 的 设备 或 具有 发 现 信息 的 设备 会 使 用 另 一 设备 上 发 现 的 资源 来 发 布 该 信息 。 共 享 信息 
的 策略 (包括 生命 周期 /有 效 性 由 发 布设 备 指定 。 发 布设 备 可 以 根据 需要 修改 这 些 策略 。 

(3) 执行 发 现 的 客户 端 可 以 向 托管 发 现 信息 的 设备 发 送 单 播发 现 请 求 , 或 者 发 送 由 设备 进行 监视 
和 响应 的 多 播 请 求 。 在 这 两 种 情况 下 ,托管 发 现 信息 的 设备 都 代表 发 布设 备 。 

(4) 发 现 策略 可 以 由 托管 发 现 信息 的 设备 设置 .也 可 以 由 正在 发 布 发 现 信息 的 一 方 来 设置 。 发 现 
响应 中 返回 的 发 现 信息 应 遵守 请 求 时 生效 的 策略 。 


6.2.3 广播 发 现 


在 广播 发 现 中 主要 完成 以 下 功能 。 

CL) 发 现 资源 托管 在 启动 发 现 请 求 (客户 端 ) 的 设备 本 地 。 用 于 启用 的 发 现 资源 可 以 作为 核心 资源 
或 作为 引导 的 一 部 分 被 发 现 。 

(20 请 求 可 以 是 实现 相关 的 查找 ,或 者 是 对 启用 发 现 资源 的 本 地 检索 请 求 。 
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(3) 要 被 发 现 信息 的 设备 应 该 向 发 现 资源 发 布 适当 的 信息 。 
(4) 发 布设 备 负责 发 布 信息 。 发 布设 备 可 以 通过 发 送 发 布 请 求 来 更 新 资源 上 的 信息 ,以 根据 其 需 
要 实现 发 现 过 程 。 被 发 现 信息 的 策略 ,包括 生命 周期 .都 是 由 发 布设 备 决定 的 。 


6.2.4 资源 信息 发 布 过 程 


使 用 资源 发 布 信息 以 实现 发 现 的 机 制 , 既 可 以 在 本 地 实现 ,也 可 以 远程 实现 。 发 布 过 程 如 图 6-5 所 
示 。 具 有 要 发 布 的 发 现 信息 设备 ,如 果 在 本 地 托管 , 则 更 新 发 现 资源 ,或 者 向 托管 发 现 资源 的 设备 发 出 
更 新 请 求 。 承 载 了 用 于 发 现 资源 的 设备 会 添加 /更 新 资源 ,以 使 用 所 提供 的 信息 来 进行 发 现 , 然 后 使 用 
更 新 响应 已 请 求 公布 资源 的 设备 。 


6.2.5 资源 发 现 信息 


发 现 过 程 如 图 6-6 Bios ,初始 化 是 以 对 资源 检索 请 求 完成 发 现 的 。 该 请 求 可 以 被 发 送 到 单个 设备 
(如 在 单 播 ) 或 多 个 设备 (如 在 多 播 ) 中 。 用 于 进行 单 播 或 多 播 的 具体 机 制 , 由 数据 连接 层 的 支持 来 确定 。 
对 请 求 的 响应 具有 被 发 现 资源 的 策略 信息 。 策 略 可 以 确定 共享 哪些 信息 、 何 时 向 代理 请 求 以 及 向 哪个 
请 求 代理 。 发 现 的 信息 可 以 是 资源 .类 型 .配置 .其 他 标准 或 用 户 方面 ,这 取决 于 对 资源 请 求 和 请 求 形 
式 。 请 求 者 可 以 选择 使 用 URI 查询 中 的 查询 参数 ,来 缩小 在 请 求 中 返回 的 信息 。 






















































































TUO" OCF 服 务 器 端 
OCF 客 户 端 To 
检索 资源 TET 
OCF 客 户 端 OCF 服 务 器 端 
1. 更 新 请 求 ,| 
1. 检索 请 求 -| 
2. 在 oic/res 
内 更 新 2. 发 现 查 询 
过 程 
加 3. 更 新 响应 3. 检索 响应 
图 6-5 ”基于 发 现 的 资源 : 信息 发 布 图 6-6 基于 发 现 的 资源 : 发 现 信 息 


一 些 核心 资源 可 能 在 所 有 的 设备 上 都 会 实现 .以 支持 发 现 过 程 。 用 来 支持 发 现 过 程 的 核心 资源 有 : 

(1) /oic/res, 用 于 资源 的 发 现 。 

(2) /oic/p, 用 于 平台 的 发 现 。 

(3) /oic/d, 用 于 设备 信息 的 发 现 。 

这 些 强 制 发 现 核心 资源 的 详细 信息 如 表 6-4 所 示 。 

1. 平台 资源 

OCF 认为 可 以 在 单个 平台 上 承载 多 于 一 个 的 设备 实例 。 客 户 需 要 一 种 方法 来 发 现 和 访问 平台 上 
的 信息 。 核 心 资 源 “/oic/p” 暴 露 平 台 特 定 的 属性 。 同 一 平台 上 的 所 有 设备 实例 应 具有 相同 的 公开 属性 
值 ( 即 设备 可 以 选择 在 “/oic/p” 中 公开 可 选 属 性 ,但 当 暴 露 时 .该 属性 值 应 与 平台 上 其 他 设备 的 该 属性 
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值 相同 ) 。 

2. 设备 资源 

设备 资源 应 具有 预定 义 的 URI。 资 源 “/oic/d” 暴 露 了 与 表 6-4 中 定义 设备 相关 的 属性 。 暴 露 的 属 
性 由 特定 的 设备 实例 确定 ,并 由 该 设备 上 的 */oic/d” 资 源 类 型 定义 。 因 为 “/oic/d" 的 所 有 资源 类 型 都 不 
是 已 知 的 ,所 以 ,“/oic/d” 的 资源 类 型 应 通过 核心 资源 “/oic/res” 的 发 现 来 确定 。 设 备 资源 “/oic/d” 应 该 
有 一 个 默认 资源 类 型 ,其 有 助 于 引导 与 此 设备 的 交互 (默认 类 型 如 表 6-4 所 示 ) 。 

表 6-4 强制 发 现 的 核心 资源 

WE LAY URI | 标题 | 资源 类 型 IDC*rt”) 接口 描 xk 功能 
资源 通过 该 接口 发 现 相应 的 服务 器 端 ,并 对 可 用 
资源 进行 检查 。“/oic/res” 将 暴露 设备 上 可 发 现 
的 资源 。 当 服务 器 端 接收 到 以 “/oic/res” (如 
/oic/res 默认 | oic. wk. res oic. if. ll | GET /oic/res) 为 目标 的 检索 请 求 时 , 它 将 用 自身 | 发 现 
所 有 可 发 现 资源 的 链接 列表 进行 响应 。“/oic/d” 
和 */oic/p" 是 可 发 现 的 资源 ,因此 ,它们 的 链接 包 
会 在 “/oic/res” 响 应 中 
/oic/p 平台 | oic. wk. p oi.if.r | 通过 平台 特定 信息 发 现 资源 发 现 
可 通过 “/oic/res" 发 现 资源 ,暴露 了 设备 实例 特 
有 的 属性 。“/oic/d” 除 了 默认 资源 类 型 之 外 还 可 














oic. wk. d 和 (或 ) 一 能 有 一 个 或 多 个 特定 于 设备 的 资源 类 型 ,或 者 如 
/oic/d 设备 | 个 或 多 个 设备 特定 | oic.if.r | 果 存 在 则 覆盖 默认 资源 类 型 。 基 本 类 型 “oic | 发 现 
的 资源 类 型 ID wk, d" 定 义 了 所 有 设备 公开 的 属性 。 暴 露 的 设 


备 特定 资源 类 型 取决 于 设备 的 类 别 ( 如 空调 、 烟 
雾 报 警 ) ,适用 值 由 垂直 规范 定义 

















3. 协议 指示 

设备 可 以 根据 不 同 应 用 配置 文件 的 需求 ,支持 不 同 的 消息 传递 协议 。 例 如 ,智能 家 庭 情况 下 可 以 使 
用 CoAP。 为 了 实现 互 操作 性 .设备 使 用 协议 来 指示 它们 支持 并 且 可 以 进行 通信 的 传输 协议 。 

K 6-5 EX T “oic. wk. res” 资 源 类 型 。 
表 6-5 “oic. wk, res” 资 源 类 型 定义 

属性 属性 名 属性 值 类 型 属性 值 规则 单位 | 访问 模式 | 是 否 强制 性 E] 述 
名 称 n 字符 串 读 L3 由 供应 商定 义 的 人 性 化 名 称 
由 设备 的 “/oic/d? 资 源 指示 的 设备 标识 
符 -“/oic/res” 中 可 能 有 多 个 “di 实例 ,但 

















BEN a | | UD x 是 | 每 个 “di" 都 有 唯一 的 值 。“di" 值 的 唯一 性 
意味 着 设备 的 资源 应 当 是 单个 “di” 的 组 合 
: 链接 数组 描述 了 URI, 支 持 的 资源 类 型 . 接 

链接 links | 数组 i E s dni 
消息 传递 协议 的 空间 分 隔 值 CSSV) 的 字符 
一 个 SI RB. i? 
dibe pen ee " g 。 | EOS ST 数 被 支持 的 。 例 如 ,1 


和 3” 表示 设备 支持 CoAP 和 HTTP 作为 
消息 协议 


























第 6 章 “OCF 的 功能 交互 | 7! 


如 果 一 个 设备 要 指示 其 消息 协议 能 力 , 可 以 在 对 “/oic/res” 的 请 求 响应 中 添加 属性 "mpro”。 设 备 
应 支持 基于 CoAP 作为 基准 发 现 机 制 。 在 发 现 响 应 中 看 到 此 属性 的 客户 端 ,可 以 选择 任何 支持 的 消息 
传递 协议 ,以 便 与 服务 器 端 进行 通信 获取 更 多 消息 。 例 如 ,如 果 支 持 多 个 协议 的 设备 指示 它 在 发 现 响应 
中 支持 “mpro” 属 性 的 值 *1,3”, 不 能 假定 存在 隐 含 的 排序 或 优先 级 。 但 是 ,垂直 服务 规范 可 以 选择 指定 
隐 含 的 顺序 或 优先 级 。 如 果 响 应 中 没有 “mpro" 属 性 , 则 客户 端 将 使 用 垂直 规范 中 指定 的 默认 消息 传递 
协议 进行 进一步 通信 。 表 6-6 提供 了 协议 方案 的 OCF 注册 表 。 


表 6-6 协议 方案 的 OCF 注册 表 





























SI 数 协 议 SI 数 协 议 
1 CoAP 4 HTTPS 

2 CoAPS 5 CoAP+TCP 
3 HTTP 6 CoAPS+TCP 


ER: 特定 协议 使 用 的 端点 发 现 不 在 讨论 范围 内 。 除 发 现 之 外 ,客户 端 用 于 在 不 同 消息 协议 中 形 
成 请 求 的 机 制 不 在 讨论 范围 内 。 

以 下 规则 适用 于 “/oic/d” 的 使 用 : 垂直 规范 可 以 选择 暴露 其 设备 类 别 ( 如 冰箱 ) ,通过 将 与 设备 类 别 
相对 应 的 资源 类 型 添加 到 与 /oic/d” 相 关联 的 资源 类 型 列表 来 实现 。 

例如 ,“/oic/d” 的 rt 变 成 “["oic. wk. d", "oic. d. < thing >"];”。 其 中 ,"oic. d. < thing >" 在 另 一 个 
规范 中 定义 ,如 智能 家 居 垂直 规范 。 

这 意味 着 /oic/d” 公 开 的 属性 默认 为 表 6-7 中 的 强制 属性 。 垂 直 规范 可 以 选择 扩展 资源 类 型 “oic 
. wk. d" 定 义 的 属性 列表 。 在 这 种 情况 下 ,垂直 规范 将 分 配 新 的 设备 类 特定 资源 类 型 ID。 表 6-7 中 定义 
的 强制 属性 应 始终 存在 。 

注意 : 根据 现 有 的 核心 规范 定义 ,资源 类 型 ID 可 以 是 资源 类 型 ID 的 列表 ; 在 这 种 情况 下 ,“/oic/d” 
的 默认 资源 类 型 ID 是 列 出 的 第 一 个 资源 类 型 。 所 以 ,一 个 垂直 规范 可 以 先 列 出 “oic. d. thing”。 这 意味 
着 GET /oic/d 会 返回 *oic. d. thing” 的 属性 ,并 且 GET /oic/d? rt 二 < some rt > 返回 查询 中 列 出 的 “rt” 
属性 。 在 表 6-7 P "oic. wk. d” 资 源 类 型 定义 了 “/oic/d” 的 基本 资源 类 型 。 

表 6-7 "oic. wk. d" 资 源 类 型 定义 


属性 属性 名 属性 值 | 属性 值 单位 访问 | 是 否 Bo 











类 型 | 规则 模式 | 强制 
设备 名 称 n 字符 串 读 | w | 由 供应 商定 义 的 人 性 化 名 称 
该 设备 实现 的 核心 规范 版 本 ,语法 是 core. < major >. 
规范 版 本 iv | 读 | 是 < minor >. < sub-version >, 其 中 ,< major >.< minor > 


和 < sub-version > 分 别 是 主 版 本 号 、 次 版 本 号 和 子 版 
本 号 ,该 版 本 的 字符 串 值 应 该 是 "core. 1.1.0" 


设备 的 唯一 标识 符 。 此 值 应 按照 设备 ID 在 OCF 安 
全 中 进行 定义 





设备 ID di UUID i 是 





























72 4|| OCF 技 术 原理 及 物 联网 程序 开发 指南 


续 表 





属性 属性 名 


属性 值 
类 型 


属性 值 
规则 


单位 


访问 


是 否 
强制 


描 xk 





数据 模型 版 本 





dmv 








CSV 























实现 该 设备 数据 模型 的 资源 规范 版 本 ; 如 果 是 针对 
垂直 特定 资源 规范 来 实现 的 ,那么 就 是 实现 该 设备 模 
型 的 规范 版 本 的 垂直 规范 。 语 法 是 以 逗号 分 隔 的 列 
表 < res >. < major 7. < minor >. < sub-version > 或 
< vertical >, < major >. < minor >, < sub-version >. 
< res > 是 字符 串 "res",< vertical > 是 在 垂直 特定 资源 
规范 中 定义 的 垂直 名 称 。< major >、< minor > 和 
< sub-version > 分 别 是 规范 的 主 版 本 号 、 次 版 本 号 和 





子 版 本 号 ,该 版 本 的 字符 串 值 应 该 是 "core. 1. 1. 0" 


“/oic/d" 资 源 的 附加 资源 类 型 由 垂直 规范 定义 。 表 6-8 XE 3C T "oic. wk. p YE MASH. 





















































表 6-8 "oic. wk. p” 资 源 类 型 定义 
属 性 属性 名 | 属性 值 类 型 | 访问 模式 | 是 否 强制 d x 
物理 平台 的 UIUID 是 根据 IETF RFC 4122 得 到 
平台 ID pi 字符 串 读 是 的 ,推荐 使 用 RFC 中 特定 的 随机 生成 方案 来 创 
建 UUID 
制造 商 名 称 mnmn | 字符 串 读 是 制造 商 的 名 称 
制造 商 细节 链接 | mnml | URI 读 否 对 制造 商 的 引用 ,表示 为 URI 
模型 号 mnmo | 字符 串 读 否 制造 商 指定 的 模型 号 
制造 日 期 mndt 日 期 读 F 设备 的 制造 日 期 
平台 版 本 mnpv | 字符 串 读 "5 平台 的 版 本 ,字符 串 (由 制造 商定 义 ) 
OS 版 本 mnos | 字符 串 读 5 平台 OS 版 本 ,字符 串 ( 由 制造 商定 义 ) 
硬件 版 本 mnhw | 字符 串 读 "y 平台 硬件 版 本 
固件 版 本 mnfv | FAR 读 "5 设备 固件 版 本 
支持 链接 mnsl URI 读 "5 指向 制造 商 的 支持 信息 的 URI 
系统 时 间 st 日 期 时 间 读 "5 设备 的 参考 时 间 
供应 商 为 平台 定义 的 字符 串 , 字 符 串 没有 格式 ,由 供 
供应 商 ID vid 字符 串 读 " 应 商 决定 填充 的 文本 
4. 复合 设备 


物理 设备 可 以 被 建 模 为 单个 设备 或 者 其 他 设备 的 组 合 。 例 如 ,冰箱 可 以 被 建 模 为 组 合 设备 ,其 定义 
的 一 部 分 可 能 包括 一 个 恒温 设备 ,因为 它 自身 是 由 可 调 温度 计 装 置 组 成 的 。 

将 服务 器 端 建 模 为 组 合 设备 的 方法 有 很 多 。 一 种 示例 方法 是 使 代表 复合 设备 的 平台 产生 具有 多 个 
设备 的 实例 。 每 个 设备 实例 表示 组 合 中 的 不 同 设备 之 一 。 设 备 的 每 个 实例 可 以 自身 具有 或 承载 其 他 资 


源 的 多 个 实例 。 


不 管 它 是 如 何 组 成 的 ,一 个 具体 实现 只 应 为 每 个 逻辑 服务 器 端 公开 带 有 资源 类 型 选项 的 “/oic/d” 


单个 实例 。 


因此 ,上 述 冰箱 实例 如 果 被 建 模 为 单个 服务 器 端 ;“/oic/res” 将 使 用 适合 于 冰箱 的 资源 类 型 名 称 来 暴 
露 “/oic/d”。 附 属 恒温 器 和 温度 计 设备 会 通过 一 个 实现 指定 相关 的 URI. 被 简单 地 暴露 为 具有 设备 适当 资 
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源 类 型 的 资源 实例 。 例 如 ,/MyHost/ MyRefrigerator/ Thermostat 和 /MyHost/ MyRefrigerator/ Thermostat/ 
Thermometer, 
5. 附加 的 发 现 资源 
附加 的 发 现 资源 可 以 被 实现 ,支持 附加 发 现 的 核心 资源 有 :“/oic/rts”, 用 于 资源 类 型 的 发 现 ; 
“/oic/ifs”, 用 于 接口 的 发 现 。 这 些 可 选 核心 资源 的 详细 信息 如 表 6-9 所 示 。 
表 6-9 可 选 的 发 现 核心 资源 


预定 义 的 URI | ”标题 资源 类 型 ID | 接口 描 xk 功能 
标识 设备 上 支持 的 资源 类 型 所 使 用 的 资源 。 资 源 类 
型 可 以 在 构建 时 预 加 载 或 预 配置 ,或 者 可 以 在 运行 时 
下 载 。 此 资源 是 只 读 的 ,这 意味 着 资源 类 型 不 能 推送 
/oic/rts | 资源 类 型 | oic. wk. rts | oic.if.r | 到 设备 (这 不 排除 设备 从 资源 类 型 注册 表 / 目 录 下 载 | 发 现 
新 类 型 ,然后 将 其 暴露 为 支持 )。 通 过 “/oic/rts” 发 现 
的 资源 类 型 用 于 指定 被 创建 的 资源 类 型 。 此 资源 被 
建 模 为 一 个 简单 的 资源 

通过 其 识别 支持 的 接口 资源 。 这 是 作为 资源 发 现 的 
/oic/ifs 接口 oic. wk. ifs | oic.if.r | 一 部 分 ,返回 每 个 资源 的 接口 信息 。 该 资源 宣布 所 支 | 发 现 
持 的 接口 可 以 用 在 该 服务 器 端 创建 资源 


























表 6-10 定义 了 “oic. wk. rts” 资 源 类 型 。 
表 6-10 "oic. wk. rts" 所 支持 的 资源 类 型 定义 


属性 | 属性 名 | 属性 值 类 型 属性 值 规 则 单位 | 访问 模式 | 是 否 强制 ti £ 
类 型 列表 tl BSV 0 到 多 种 资源 类 型 ID 读 是 设备 支持 的 资源 类 型 列表 





K 6-11 EX T “oic. wk. ifs” 资 源 类 型 。 
表 6-11 "oic. wk. if FRADE MX 


属性 属性 名 | 属性 值 类 型 属性 值 规则 单位 | 访问 模式 | 是 否 强制 d xk 
接口 列表 il BSV 0 到 很 多 资源 接口 读 是 设备 支持 的 资源 接口 列表 





6.2.6 ”使 用 “/oic/res” 的 资源 发 现 


使 用 “/oic/res” 的 资源 发 现 是 默认 的 发 现 机 制 . 所 有 的 设备 都 会 支持 ,具体 实现 如 下 。 

CD 每 个 设备 更 新 其 本 地 “/oic/res” 与 那些 可 发 现 的 资源 。 每 次 在 设备 上 实例 化 新 资源 时 .如 果 该 
资源 可 由 远程 设备 发 现 , 则 与 设备 本 地 的 /oic/res” 资 源 (作为 实例 化 资源 ) 一 起 发 布 。 

(2) 如 果 一 个 设备 想 要 在 一 个 或 多 个 远程 设备 上 发 现 资源 或 资源 类 型 , 则 该 设备 就 会 向 远程 设备 
上 的 “/oic/res” 发 出 检索 请 求 。 只 要 探测 到 一 个 特定 主机 , 则 该 请 求 就 可 以 被 多 播 ( 默 认 ) 或 单 播发 送 。 
还 可 以 选择 在 请 求 的 查询 部 分 使 用 适当 子 句 来 限制 检索 请 求 。 查 询 可 以 基于 资源 类 型 .接口 或 属性 进 
行 选择 。 

(3) 查询 应 用 于 资源 的 表示 。“/oic/res” 是 唯一 表示 中 有 “rt” 的 资源 。 所 以 “/oic/res” 是 可 以 用 于 
传输 协议 层 多 播发 现 的 唯一 资源 。 
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(4) 接收 检索 请 求 的 设备 以 资源 列表 、 每 个 资源 的 类 型 和 支持 的 接口 进行 响应 。 此 外 ,还 可 以 发 送 
关于 资源 活动 上 的 策略 信息 ,支持 的 策略 包括 可 观察 性 和 可 发 现 性 。 

(5) 基于 “/oic/res" 请 求 返 回 的 资源 ,接收 设备 可 以 进行 更 深层 的 发 现 。 

“/oic/res” 发 现时 返回 的 信息 至 少 应 该 包括 以 下 几 点 。 

OD 资源 的 URI( 相 对 或 完全 限定 URL): 每 个 资源 的 类 型 。 如 果 资 源 启用 多 种 类 型 , 则 可 以 返回 
多 种 资源 类 型 。 要 访问 多 种 类 型 的 资源 ,应 在 请 求 中 指定 目标 的 特定 资源 类 型 。 

(2) 该 资源 支持 的 接口 。 可 以 返回 多 个 接口 。 要 访问 特定 接口 ,应 在 请 求 中 指定 接口 。 如 果 未 指 
定 接口 , 则 假定 为 默认 接口 。 

(3) 针对 该 资源 定义 的 策略 。 这 些 策 略 可 以 是 与 安全 相关 的 访问 模式 、 交 互 类 型 等 。 除 了 请 求 / 响 
应 类 型 的 交互 ,规范 允许 资源 被 “观察 ”。 

前 文 已 经 描述 了 使 用 “/oic/res” 发 现 的 JSON 模式 。 关 于 在 CoAP 传输 上 使 用 */oic/res? 多 播发 现 
的 详细 信息 ,参见 第 5 章 的 终端 发 现 。 

使 用 */oic/res” 执 行 发 现 功 能 后 ,客户 端 可 以 通过 使 用 */oic/p”*/oic/rts” 等 执行 发 现 功 能 ,发 现 有 
关 服 务 器 的 更 多 详细 信息 。 如 果 客 户 端 已 经 知道 服务 器 端 , 它 可 以 使 用 其 他 资源 发 现 ,而 不 会 通过 


“/oic/res”。 


6.2.7 基于 资源 目录 的 发 现 


直接 发 现 是 当前 用 来 在 网 络 中 查找 资源 的 机 制 。 当 需要 时 ,在 特定 节点 处 直接 查询 资源 ,或 者 向 所 
有 节点 发 送 组 播 分 组 。 每 个 被 查询 的 节点 直接 用 其 可 发 现 的 资源 对 发 现 设备 做 出 响应 。 本 地 可 用 的 资 
源 在 同一 设备 上 注册 。 

在 某 些 情况 下 ,间接 发 现 也 是 需要 的 。 间 接 发 现 是 指 第 三 方 设备 (发 现 设备 和 被 发 现 设备 除外 ) 协 
助 发 现 过程 。 第 三 方 设备 仅 提供 代表 另 一 个 设备 的 资源 信息 .但 不 会 在 该 设备 上 承载 资源 。 图 6-7 是 
通过 资源 目录 间接 发 现 资源 的 过 程 。 其 中 ,设备 B 作为 设备 A 和 设备 D 的 资源 目录 ; 设备 A 和 设备 D 
































不 回复 多 播发 展 。 

“/oic/res” 
(设备 A) 

uer DERE 

发 布 资源 (设备 B) | “| ocF( 设 备 C) 

多 播发 现 
“/oic/res” 
(设备 D) 


6-7 通过 资源 目录 间接 发 现 资源 的 过 程 


间接 发 现 对 于 资源 受 限 设备 是 有 用 的 ,例如 ,设备 需要 休眠 进行 功率 管理 而 不 能 处 理 每 个 发 现 请 
求 ,或 者 当 设备 可 能 不 在 相同 的 网 络 上 而 需要 对 发 现 进行 优化 。 一 旦 使 用 间接 发 现 功 能 .发 现 了 资源 ， 
则 可 以 直接 向 承载 该 资源 的 设备 发 送 请 求 ,完成 对 资源 的 访问 。 

资源 目录 (RD) 是 辅助 间接 发 现 的 设备 。 可 以 在 其 */oic/res” 资 源 中 查询 RD, 以 查找 承载 在 其 他 设 
备 上 的 资源 。 这 些 设备 可 以 是 睡眠 节点 或 不 能 响应 发 现 请 求 的 任何 设备 。 设 备 可 以 将 它们 承载 的 所 有 
或 部 分 资源 列表 发 布 到 一 个 RD。 然 后 ,RD 代表 发 布设 备 响应 对 资源 发 现 的 查询 (例如 当 设 备 进入 睡 
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眠 时 )。 对 于 一 般 资源 的 发 现 ,RD 在 响应 对 “/oic/res” 的 请 求 方面 与 其 他 服务 器 一 样 。 

任何 服务 或 作为 RD 的 设备 应 公开 一 个 众所周知 的 资源 “/oic/rd”。 想 要 发 现 RD 的 设备 将 使 用 该 
资源 和 资源 发 现 机 制 , 发 现 RD 并 获取 RD 的 参数 。 通 过 该 资源 发 现 的 信息 ,应 该 用 于 选择 适当 的 RD. 
进一步 用 于 资源 发 布 。 加 权 信息 应 包括 以 下 标准 : 电源 (AC、 电 池 供 电 或 安全 /可 靠 ), 连 接 ( 无 线 、 有 
AD ,CPU, 内 存 和 负载 统计 (处 理发 布 和 从 设备 查询 )。 此 外 .RD 将 返回 0 一 100 的 偏差 因子 。 作 为 可 
选 ,RD 还 可 以 返回 上 下 文 , 它 是 字符 串 的 值 ,上 下 文 的 语义 在 本 书 中 不 讨论 ,但 是 它 将 用 于 建立 对 应 
用 、 部 署 、 使 用 有 意义 的 领域 .区 域 或 类 似 的 范围 。 

通过 使 用 这 些 标 准 或 偏 置 因子 .设备 应 选择 一 个 RD( 每 个 上 下 文 ) 以 公布 其 资源 。 上 下 文 是 来 自 
另 一 个 用 于 资源 发 现 .一 组 客户 端 或 者 任何 一 组 的 情况 。 上 下 文通 常 在 部 署 时 根据 应 用 程序 需求 确定 。 
例如 ,上 下 文 可 以 是 多 播 组 ,作为 多 个 多 播 组 的 成 员 设备 ,可 能 必须 在 每 个 多 播 组 ( 即 每 个 上 下 文 ) 中 找 
到 ,并 选择 RD 以 发 布 其 信息 。 设 备 可 以 决定 在 其 生存 期 内 选择 其 他 RD, 但 是 设备 在 任何 情况 下 ,都 不 
会 将 其 资源 信息 发 布 到 具有 上 下 文 的 多 个 RD。 与 移动 电话 设备 相 比 ,诸如 电视 .网络 路 由 器 、 台 式 机 
之 类 的 设备 将 具有 更 高 的 权重 或 偏 置 因 子 。 

6.2.7.1 资源 目录 发 现 

OCF 网 络 中 的 RD 应 支持 RD 发 现 、 提 供 相关 设施 允许 设备 向 RD 发 布 其 资源 信息 、 更 新 资源 信 
息 , 以 及 从 RD 删除 资源 信息 的 功能 。 如 图 6-8 所 示 , 希 望 广播 其 资源 的 设备 首先 发 现 资源 目录 ,然后 
发 布 所 需 的 资源 信息 。 一 旦 一 组 资源 被 发 布 到 RD, 则 当 RD 在 相同 的 多 播 域 上 时 ,发 布设 备 将 不 响应 
针对 这 些 发 布 资源 的 多 播 资 源 发 现 查 询 。 在 这 种 情况 下 ,只 有 RD 根据 发 布 给 它 的 资源 ,响应 多 播 资 源 


; 设备 B 设备 C 
设备 A (作为 资源 目录 ) (发 现 ) 

















mE 
| www | "iem 
发 布 资源 
多 播 资源 发 现 
不 回复 单 播 回复 设备 
A 、B 的 资源 











图 6-8 RD 发 现 和 RD 支持 的 资源 支持 查询 


OCF 网 络 允 许多 个 设备 充当 RD。 有 多 个 RD 支持 的 原因 是 使 网 络 可 扩展 ,处 理 网 络 故障 和 集中 
的 设备 故障 瓶颈 。 并 不 排除 这 样 一 种 情况 : 其 中 用 例 或 部 署 环境 可 能 需要 将 环境 中 的 单个 设备 部 署 为 
唯一 资源 目录 (例如 网 关 模型 )。 除 此 之 外 ,在 平台 上 可 能 有 多 个 设备 充当 RD. 

RD 的 发 现 可 能 导致 来 自 多 个 RD 的 响应 。 发 现 设备 应 选择 一 个 RD。 该 选择 可 以 基于 来 自 RD 的 
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响应 中 提供 的 权重 参数 。 

RD 对 应 用 是 不 可 知 的 , 即 应 用 不 应 该 知道 资源 目录 是 否 被 查询 以 获得 资源 信息 。 所 有 检索 处 理 
对 于 应 用 是 不 透明 的 。 执 行 资源 发 现 的 客户 端 使 用 RD, 就 像 它 可 以 使 用 任何 其 他 服务 器 端 进 行 发 现 
一 样 。 当 它 仅 需 要 在 RD 上 广播 资源 时 ,可 以 向 RD 发 送 单 播 请 求 . 或 者 当 它 不 需要 或 具有 RD 的 显示 
知识 时 ,可 以 进行 多 播 查询 。 资 源 目录 的 部 署 方 式 如 图 6-9 所 示 。 



























































平台 平台 
OCF 设 备 OCF 设 备 。 OCF 设 备 
“/oic/res” “icles” | | es 
“Joic/rd” “foicira” | | “TS 
OCF 设 备 作 为 


发 现 资源 目录 的 平 
一 个 资源 目录 发 现 资源 目录 的 平台 


图 6-9 资源 目录 的 部 署 方 式 


当然 ,也 可 以 用 以 下 方式 发 现 资源 目录 。 

COD 预 配置 : 希望 发 布 资源 信息 的 设备 可 以 预先 配置 特定 资源 目录 的 信息 (例如 TP 地址、 端口 和 传 
输 等 ) 。 预 配置 可 以 在 On-Boarding 时 完成 ,或 者 可 以 使 用 其 他 方法 在 设备 上 更 新 , 预 配置 可 以 由 制造 
商 或 由 用 户 / 设 备 管理 器 来 完成 。 

(2) 面向 查询 : 想 要 使 用 面向 查询 的 发 现 来 发 现 资源 目录 的 客户 端 ,应 该 发 出 针对 “/oic/rd” 资 源 
的 多 播 资 源 发 现 请 求 。 只 有 可 以 作为 RD 的 设备 可 以 托管 /oic/rd”, 并 且 响 应 此 查询 ,所 有 这 些 设备 都 
应 该 可 以 托管 “/oic/rd” 并 响应 此 查询 。 响 应 应 该 包括 关于 RD( 由 资源 类 型 定义 ) 和 权重 参数 的 信息 ， 
以 允许 发 现 设备 在 RD 之 间 进 行 选择 (参见 RD 选择 部 分 中 的 详细 信息 )。*/oic/rd” 资 源 在 某 些 条 件 下 
是 强制 性 核心 资源 ,只 有 在 提供 或 充当 资源 目录 时 . 才 会 在 所 有 设备 上 实例 化 。 对 一 个 “oic/rd” 查 询 响 
应 中 的 相关 信息 ,如 下 所 示 。 


{ 
" $ schema": "http://json— schema. org/draft — 04/schema # ", 
"id" :" http: //openinterconnect. org/schemas/oic. rd. selection. json#", 
"title" : "RD Selection", 
"definitions": ( 
"oic. rd. attributes": { 
"type": "object", 
"properties": ( 

"uhi 
"type": ". 
"description": "A human friendly name for the Resource Directory", 
"format": "UTF8" 

Lh 

"di": { 
"type": "string", 

"description": "A unique identifier for the Resource Directory", 


string", 
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"format": "uuid" 
Lh 
"sel": ( 
"description": "Selection criteria that a device wanting to publish to any RD can use to choose this 
Resource Directory over others that are discovered", 
"oneOf": [ 
t 
"type": "object", 
"properties": ( 
"par": ( 
"type": "string", 
"enum": [ "ac", "batt", "safe" ], 
"description": "A hint about how the RD is powered. If AC then this is stronger than battery 
powered. If source is reliable (safe) then appropriate mechanism for managing power failure exists" 








Lh 
"conn" : 
"type": "string", 
"enum": [ "wrd", "wrls" ], 


"description": "A hint about the networking connectivity of the RD. * wrd* if wired connected 
and *wrls* if wireless connected." 
) 
"cpu": ( 
"type": "integer", 
"description": "Memory available at request in MHz units" 
) 
"memory": ( 
"type": "integer", 
"description": "A processing capacity of the CPU specified in MB units" 


n 

"load": ( 
"type": "array", 
"items": { 


"type": "number", 
Lh 
"ninitems": 3, 
"maxitems": 3, 
"description": "Current load capacity of the RD. Expressed as a load factor 3 - tuple (upto 
two decimal points each). Load factor is based on request processed in a 10 minute window, in the last hour and 
hourly average over the RD current lifetime" 


"type": "integer", 

"minimum": 0, 

"maximum": 100, 

"description": "A bias factor calculated by the Resource directory — the value is in the range of 
0 to 100 — 0 implies that RD is not to be selected. Client chooses RD with highest bias factor or randomly 
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between RDs that have same bias factor" 





] 
H 

Lh 
"required": [ "sel" ] 
} 
) 
"type": "object", 
" $ ref": "#/definitions/oic. rd. attributes” 
} 


(3) 广播 /存在 : RD 可 以 向 设备 广告 其 存在 。 它 是 存在 和 广播 包 的 组 合 。 已 经 发 布 到 RD 的 设备 
可 以 将 其 用 作 RD 的 存在 或 心跳 消息 。 如 果 RD 广播 未 以 规定 的 间隔 到 达 , 则 发 布设 备 开 始 搜索 网 络 
中 的 其 他 RD, 因 为 该 信号 表示 RD 不 在 线 。 这 个 消息 的 其 他 用 法 是 将 其 作为 广播 ,对 设备 寻求 RD 并 
发 布 其 资源 。 来 自 广播 的 细节 可 以 直接 用 于 查询 RD, 以 获得 加 权 细节 ,而 不 是 在 网 络 中 发 送 组 播 分 
组 。 按 照 预期 ,这 是 以 规则 间隔 发 送 的 ,并 且 不 包括 用 于 保持 分 组 大 小 的 权重 信息 。 

RD 的 一 个 重要 优点 是 使 服务 在 不 支持 站 点 范围 的 组 播 ,但 支持 站 点 范围 的 路 由 网 络 中 可 被 发 现 。 
这 样 网 络 的 典型 例子 就 是 家 庭 网 络 。 为 了 在 这 样 的 网 络 上 启用 RD 功能 ,需要 站 点 发 现 机 制 来 发 现 RD 
服务 (IP 地 址 和 端口 号 )。 支 持 混合 代理 的 家 庭 网 络 允许 基于 “dns-sd/ mDNS” 站 点 范围 内 的 发 现 。 为 
了 使 自身 在 链 路 本 地 范围 之 外 可 被 发 现 , 具 有 可 路 由 IP 地 址 的 RD 将 实现 mDNS 响应 者 需求 ,其 在 
IETF RFC 6762 中 定义 。RD 将 响应 PTR 类 型 .服务 名 称 等 于 *_rd. sub. oic. udp.local"fl] mDNS 
查询 。 响 应 应 该 包括 所 有 可 路 由 的 IP 地 址 。 具 有 可 路 由 IP 地 址 的 设备 应 通过 一 个 服务 名 称 为 *_rd. _ 
sub. oic. udp.local"fl] DNS-SD PTR 查找 (IETF RFC 6763 中 定义 ) ,发现 所 有 可 用 的 RD 实例 。 响 
应 应 包括 所 有 可 路 由 地 址 /端口 ,可 通过 它们 使 RD 服务 被 访问 。 

当 设 备 发 现 多 个 RD 时 , 它 将 基于 选择 标准 决定 使 用 哪个 RD。 设 备 将 在 给 定时 间 仅 使 用 多 播 域 
内 的 一 个 RD, 或 向 多 播 域内 的 一 个 RD 发 布 信息 。 这 是 为 了 最 小 化 资源 发 现 阶 段 处 理 重 复 信 息 的 
负担 。 

有 两 种 方法 可 以 选择 RD; 一 种 方法 是 基于 加 权 或 偏差 因子 (RD 生成 ); 另 一 种 方法 是 基于 服务 
器 端 (生成 的 客户 端 /设备 ) 提 供 客户 端的 粒度 参数 确定 。 设 备 可 以 使 用 其 中 一 种 或 两 种 方法 来 选 
择 RD。 

偏差 因子 : 由 服务 器 端 生成 的 正 数 ,范围 为 0 一 100. 其 中 0 是 最 低 的 ,100 是 最 高 的 。 如 果 两 个 RD 
具有 相同 的 偏差 因子 , 则 设备 可 以 基于 辅助 标准 或 者 随机 选择 。 无 论 哪 种 方式 ,每 次 只 能 选择 和 使 用 一 
个 RD, f£ OCF1.1 规范 中 并 没有 明确 定义 RD 偏差 因子 的 具体 方法 。 该 数 可 以 在 RD 的 On-Boarding 
或 后 续 配 置 时 预 配置 ,也 可 以 由 RD 实现 的 公式 来 确定 .OCF 将 在 未 来 版 本 中 为 此 计算 提供 标准 公式 。 

偏差 因子 应 由 RD 计算 .将 表 6-12 中 每 个 参数 确定 的 值 (贡献 ) 加 到 一 起 ,并 除 以 参数 的 数量 。 当 
RD 具有 足够 能 力 时 ,例如 ,服务 提供 商 网 关 .RD 可 以 广播 大 于 计算 值 的 偏差 因子 。 

参数 : 可 以 在 发 现 响应 中 选择 返回 表 6-12 中 定义 的 参数 ,如 直接 电源 、 网 络 连接 、 负 载 条 件 、 
CPU 功率 和 内 存 等 。 发 现 设备 可 以 使 用 细节 ,基于 客户 端 定义 的 RD 参数 策略 和 标准 ,做 出 粒度 选择 
决策 。 例 如 ,工业 部 署 中 的 设备 可 以 将 电力 连接 所 占 比 重 降低 ,而 在 家 庭 环境 中 ,设备 电力 权重 应 该 高 
一 些 。 
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表 6-12 选择 参数 
$ & 值 (贡献 ) 描 述 
安全 (100) 安全 意味 着 电源 可 靠 , 并 且 备 有 电池 预防 停电 等 。 实 现时 可 能 会 根据 RD 
功率 AC(70) 设备 运行 的 电池 类 型 降低 电池 数量 。 如 果 电 池 节 电 是 重要 的 ,那么 这 个 数 
电池 (40) 字 应 该 降低 
固定 (100) 实现 可 以 基于 RD 设备 的 移动 性 来 进一步 对 移动 性 数量 进行 分 级 ; 较 低 的 
移动 性 移动 (50) 数字 对 应 于 高 度 移动 性 , 较 大 数量 对 应 于 有 限 移动 性 ; 移动 性 数字 不 应 该 
大 于 80 
类 型 ， 
有 线 (10) 
无 线 (4) 
网 络 乘积 ipd Weg 2 Fe BL — [SCR * 每 个 网 络 接口 的 带宽 )]/ 接 口 的 数量 , 归 一 化 到 100 
低 (5) 
有 损耗 (3) 
接口 数量 
存储 器 是 用 于 存储 资源 信息 的 易 失 性 或 非 易 失 性 存储 器 ; 内 存 因 子 一 [可 
AEAT ARR A 用 的 ]/[ 总 的 ]， 归 一 化 到 100( 即 以 百分数 表示 ) 
RD 当前 的 请 求 负载 ,与 UNIX 负载 因子 类 似 ( 使 用 可 观察 、 待 决定 和 处 理 
lmin WR ,而 不 是 可 运行 进程 ); 表示 为 负载 因子 3 元 组 (每 个 最 多 两 个 小 数 ) 。 
请 求 加 载 因素 | 5min 因子 基于 在 lmin(L1)、5min(L5) 和 15min(L15) 窗 口中 处 理 的 请 求 见 
15min http://www. teamquest. com/import/pdís/whitepaper/ldavgl. pdf; 因子 = 
100—(L1* 3 十 L5* 7 十 L15 * 10)/3 








发 布设 备 使 用 广播 和 查询 机 制 来 查找 RD。 基 于 选择 过 程 将 如 何 工作 ,有 如 下 4 种 情况 。 

COD. 当 新 设备 启动 时 ,单个 或 多 个 RD 已 经 存在 于 网 络 中 。 

(2) 网 络 中 不 存在 RD, 并 且 新 设备 启动 。 

(3) 另 一 个 设备 启动 ,具有 RD 的 能 力 。 

(4) 两 个 RD 同时 启动 ,例如 电源 发 生 故障 后 。 

第 1 种 情况 下 ,RD 已 经 存在 了 ,设备 监听 广播 分 组 或 者 查询 多 播 地 址 上 的 RD。 如 果 接 收 到 单个 
或 多 个 响应 , 则 发 布设 备 使 用 来 自 查询 响应 的 权重 信息 来 选择 要 发 布 资 源 的 RD。 

第 2 种 情况 下 ,设备 将 监听 广播 。 一 旦 接收 到 RD 广播 分 组 ,就 可 以 接收 权重 信息 或 检索 它 , 如 果 
偏 置 因子 满足 其 标准 , 则 可 以 在 RD 上 注册 其 资源 。 

第 3 种 情况 下 ,如 果 发 布设 备 正在 向 现 有 RD 发 布 并 且 发 现 新 的 RD, 相 对 偏 置 因子 有 利于 新 的 
RD, 则 发 布设 备 可 以 选择 移动 到 新 的 RD。 如 果 决 定 选择 新 的 RD, 则 发 布设 备 将 从 先前 的 RD 中 删除 
其 资源 信息 ,然后 将 该 信息 发 布 到 新 的 RD( 在 过 渡 期 间 , 一 旦 发 送 了 删除 请 求 ,发 布设 备 将 响应 资源 发 
现 请 求 )。 

第 4 种 情况 下 ,每 个 RD 启动 并 且 广 播 它们 的 存在 。 基 于 权重 标准 的 发 布设 备 ,选择 适当 的 RD 用 
于 发 布 其 资源 信息 。 

6.2.7.2 资源 发 布 

在 RD 的 选择 过 程 之 后 ,设备 可 以 选择 以 下 机 制 : 将 其 资源 信息 推送 到 所 选 的 RD 或 请 求 RD 通过 
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对 其 "/oic/res” 执 行 单 播发 现 请 求 , 获 取 资 源 信息 。 

发 布设 备 可 以 决定 在 资源 目录 上 发 布 所 有 资源 还 是 少量 资源 。 发 布设 备 只 能 发 布 通过 其 他 方式 发 
布 到 自己 “/oic/res” 的 资源 。 对 于 不 向 RD 发 布 的 资源 ,发 布设 备 可 以 响应 发 现 请 求 ( 在 其 "/oic/res” 资 
源 上 )。 尽 管 如 此 ,强烈 建议 在 使 用 RD 时 .将 发 布 者 的 所 有 可 发 现 资源 发 布 到 RD, 

1. 发 布 : 推送 资源 信息 

fiti FH" oic. wk. rdpub” 资 源 类 型 “oic. if. baseline” 接 口 ,进行 CRUDN 操作 将 资源 信息 发 布 到 */oic/ 
rd", 

一 且 发 布设 备 向 RD 发 布 了 资源 , 它 可 以 不 响应 针对 自己 */oic/res” 相 同 资源 的 多 播发 现 查询 , 特 
别 是 当 与 RD 处 于 相同 的 多 播 域 时 。 在 发 布 资源 之 后 ,RD 负责 回复 对 已 发 布 资源 的 查询 。 

如 果 发 布设 备 处 于 睡眠 模式 ,并 且 RD 已 经 代表 发 布设 备 进行 了 答复 , 则 发 现 设备 将 尝试 访问 所 提 
供 的 URI 上 的 资源 。 

可 能 资源 目录 和 发 布设 备 都 响应 了 来 自发 现 设备 的 多 播 查询 ,这 将 创建 重复 的 分 组 ,但 是 可 以 用 于 
不 可 靠 网 络 的 一 种 选择 。 我 们 并 不 推荐 这 种 方式 ,不 过 对 于 工业 场景 ,这 确实 是 一 种 可 能 性 。 无 论 哪 种 
方式 ,发现 客 户 端 应 始终 准备 在 响应 多 播发 现 请 求 时 ,处 理 重复 的 信息 。 发 布 及 推送 资源 信息 的 过 程 
如 下 。 


{ 
" $ schema": "http://json— schema. org/draft - 04/schema & ", 
"id": "http: //openinterconnect. org/schemas/oic. rd. publish. json#", 
"title": "RD Publish & Update", 
"definitions": { 
"oic. rd. publish": { 
"type": "object", 
"description": "Publishes resources as Links into the resource directory", 
"properties": { 
"Bs 
"type": "string", 
"description": "Readonly, Human friendly name of the publishing Device" 


"type": "string", 

"description": "ReadOnly, Unique identifier (UUID) for device that is publishing", 

"format": "uuid" 

)h 
" $ ref": "oic. collection. json# /def initions/oic.collection. setoflinks/properties", 
"36": 

"type": "integer", 

"description": "Time to indicate a RD, how long to keep this published item. After this time (in 
seconds) elapses, the RD invalidates the links. To keep link alive the publishing device updates the ttl using 
the update schema" 

) 
}, 
"dependencies": { 
"kinke": f "w 
} 
} 
Lh 
"type": "object", 
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" $ ref": "#/definitions/oic. rd. publish", 
"required": [ "di" ] 

) 

2. 更 新 资源 信息 

服务 器 端 将 保存 发 布 资 源 信息 ,直到 生存 时 间 字 段 中 指定 的 时 间 。 如 果 设 备 寻 求 RD 来 保持 资源 
并 代表 其 回复 查询 , 则 设备 可 以 发 送 更 新 ,可 用 于 在 RD 上 发 布 的 所 有 资源 ,或 者 根据 已 发 布 的 每 个 资 
源 进行 更 新 。 

使 用 与 初始 发 布 相同 的 资源 类 型 和 接口 完成 更 新 .但 只 在 有 效 载荷 中 提供 要 更 新 的 信息 。 

3. 删除 资源 信息 

资源 目录 中 保持 的 资源 信息 可 以 由 发 布设 备 随 时 删除 。 它 可 以 是 整个 设备 信息 ,也 可 以 是 特定 资 
源 。 该 资源 应 仅 在 设备 满足 特定 要 求 时 允许 ,因为 它 可 能 会 产生 潜在 的 安全 问题 。 

当 要 删除 来 自 设备 的 所 有 资源 信息 时 ,使 用 设备 ID 作为 删除 请 求 查询 中 的 标签 进行 删除 。 在 特定 
资源 的 情况 下 ,删除 请 求 将 在 查询 中 包括 实例 “ins" 标 签 以 及 设备 ID. 

在 RD 提取 资源 信息 的 情况 下 ,不 能 选择 性 删除 单个 资源 的 信息 。 发 布设 备 可 以 请 求 删除 ,但 是 仅 
针对 RD 已 经 从 该 设备 提取 的 所 有 资源 信息 。 在 这 种 情况 下 ,删除 请 求 在 查询 中 具有 设备 “id" 的 标记 。 

4. 将 资源 信息 进行 RD 转移 

当 发 布设 备 识别 出 更 适合 的 RD 时 , 它 可 能 会 决定 向 该 RD 发 布 。 由 于 设备 每 次 只 能 发 布 一 个 
RD, 因 此 ,客户 端 应 确保 先前 发 布 的 信息 在 发 布 到 新 选择 的 RD 之 前 ,从 当前 使 用 的 RD 中 删除 ,可 以 通 
过 允许 生存 时 间 到 期 或 显 式 地 删除 资源 信息 ,完成 资源 的 删除 。 多 个 RD 之 间 不 应 相互 传送 资源 信息 ， 
客户 端 有 责任 选择 RD 并 管理 已 发 布 的 资源 。 

6.2.7.3 资源 发 现 

基于 发 现 过 程 的 查询 与 没有 RD 的 情况 保持 相同 。 可 以 通过 发 送 多 播 或 单 播 请 求 来 查询 “/oic/ 
res” 资 源 , 进 一 步 发 现 资源 。 在 多 播发 现 请 求 的 情况 下 .RD 将 对 承载 资源 的 设备 做 出 响应 。 客 户 端 应 
准备 处 理 来 自 多 个 RD、 具 有 相同 信息 的 重复 资源 信息 ,或 者 来 自 一 个 RD 的 重复 资源 信息 ,并 且 主 机 设 
备 ( 公 布 资源 信息 ) 都 应 该 响应 请 求 。 与 使 用 RD 发 现 的 资源 交互 相同 ,通过 查询 承载 资源 设备 的 /oic/ 
res" 资 源 也 使 用 相同 的 机 制 和 方法 (例如 ,连接 到 资源 和 对 资源 执行 CRUDN 操作 ) 。 

资源 目录 应 该 支持 DTLS。 设 备 和 资源 目录 之 间 的 通信 应 该 尽 可 能 地 基于 DTLS。 设 备 和 资源 目 
录 应 该 尽 可 能 使 用 PSK ,证书 和 原始 公 钥 进行 身份 验证 。 

设备 在 注册 之 后 应 该 使 用 UUID 与 资源 目录 进行 通信 , 即 检索 、 更 新 和 删除 应 当 使 用 UUID, 因 为 
IP 地 址 可 以 改变 资源 所 在 的 位 置 并 且 会 混淆 资源 目录 。 

访问 控制 列表 应 该 用 于 发 布 和 查找 目的 ,因为 它们 可 能 不 同 。 查 找 应 检查 请 求 来 源 、 网 络 或 资源 
级 别 。 

请 求 通配符 查找 时 ,资源 目录 应 该 能 够 进行 路 由 检查 ,以 避免 DDoS 攻击 的 情况 下 返回 。 由 于 通过 
UDP 不 可 能 检查 路 由 ,因此 ,通配符 查找 应 仅 支持 DTLS、TCP 或 TLS。 


6.3 通知 


服务 器 端 应 支持 通知 操作 ,以 使 客户 端 能 够 以 异步 方式 请 求 并 获取 一 个 或 多 个 资源 的 状态 通知 。 
那么 ,如 何 实现 将 更 新 传递 给 请 求 者 ? 在 OCF 规范 中 是 通过 观察 机 制 实现 的 。 
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在 观察 机 制 中 ,客户 端 利用 检索 操作 ,在 资源 状态 改变 的 情况 下 ,要 求 服务 器 端 进行 更 新 。 观 察 机 


制 如 图 6-10 所 示 。 注 意 , 观 察 机 制 只 能 用 于 具有 可 观察 属 
性 的 资源 。 OCF 客 户 端 OCF 服 务 器 端 
1. 有 观察 指示 的 检索 请 求 















































如 果 状 态 发 生 改变 , 则 客户 端 向 服务 器 端 发 送 检索 请 FS 
求 消息 ,以 请 求 对 服务 器 端 上 的 资源 更 新 。 检 索 请 求 消息 e 1 
会 携带 以 下 参数 。 2. 观察 请 求 
CD. fr: 客户 端的 唯一 标识 符 。 mr 
(2) to: 客户 端 请 求 观察 的 资源 。 3. 检索 响应 1 
(3) ri 检索 请 求 的 标识 符 。 [ wu ý O 
(4) op: 检索 。 
(5) obs; 观察 请 求 的 指示 。 eal 
2. 服务 器 端的 处 理 5. 检索 响应 2 
在 接收 到 检索 请 求 之 后 ,服务 器 端 会 验证 客户 端 是 否 (观察) 
具有 所 请 求 的 操作 权限 ,并 且 属性 是 可 读 和 可 观察 的 。 如 
果 验 证 成 功 , 则 服务 器 端 缓存 与 观察 请 求 相关 的 信息 。 服 图 6-10 观察 机 制 


务 器 端 还 会 缓存 来 自 检索 请 求 “ri" 的 参数 值 , 以 便 在 状态 改 
变 的 情况 下 用 于 初始 响应 和 未 来 响应 。 

3. 有 观察 指示 的 检索 响应 

服务 器 端 会 传输 一 个 检索 响应 消息 ,以 响应 来 自 客 户 端的 检索 请 求 消息 。 如 果 验 证 成 功 , 则 响应 包 
括 一 个 观察 指示 。 如 果 没 有 验证 成 功 , 则 响应 中 会 省 略 观察 指示 ,向 请 求 客户 端 通知 不 允许 通知 注册 。 
检索 响应 消息 应 包括 以 下 参数 。 

(1) fr; 服务 器 端的 唯一 标识 符 。 

(2) to: 客户 端的 唯一 标识 符 。 

(3) ri: 检索 请 求 中 包含 的 标识 符 。 

(4) en; 客户 端 请 求 的 信息 资源 表示 。 

(5) rs: 检索 操作 的 结果 。 

(6) obs: 响应 对 一 个 观察 请 求 做 出 的 指示 。 

4. 服务 器 端的 资源 监测 

服务 器 端 应 监视 来 自 客户 端 观察 请 求 中 标识 的 资源 状态 。 当 观察 到 的 资源 状态 发 生 改变 时 ,服务 
器 端 发 送 具 有 观察 指示 的 另 一 个 检索 响应 。 该 机 制 不 允许 客户 端 指定 触发 通知 的 任何 边界 或 限制 ,该 
决定 完全 留 给 服务 器 端 处 理 。 

5. 其 他 有 观察 指示 的 检索 响应 

在 观察 到 由 客户 端 指示 的 资源 状态 发 生 改变 之 后 .服务 器 端 将 会 传送 更 新 检索 的 响应 消息 。 

6. 取消 观察 

客户 端 可 以 通过 向 其 观察 的 服务 器 端 上 资源 发 送 没 有 观察 指示 字段 的 检索 请 求 , 显 式 地 取消 观察 。 
对 于 某 些 协议 映射 ,客户 端 还 能 够 通过 停止 检索 响应 来 取消 观察 。 
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6.4 设备 管理 


设备 管理 包括 诊断 和 维护 。 本 版 规范 中 指定 的 设备 管理 功能 旨 在 解决 基本 设备 管理 功能 。 预 期 在 
未 来 版 本 的 规范 中 会 增加 新 的 设备 管理 功能 。 框 架 中 的 诊断 和 维护 功能 旨 在 供 管理 员 使 用 ,以 解决 现 
场 操作 时 遇 到 的 设备 问题 。 如 果 设 备 支持 诊断 和 维护 , 则 应 支持 核心 资源 “/oic/mnt”, 如 表 6-13 所 示 。 


表 6-13 可 选 的 诊断 和 维护 设备 管理 核心 资源 














预定 义 的 URI | 资源 类 型 标题 pecia 接口 d xk 相关 的 功能 交互 
r 
/oic/ mnt 维护 oic. wk. mnt. | oic. if. rw | 设备 维护 所 用 的 资源 ,可 用 于 诊断 目的 设备 管理 














K 6-14 X T “oic. wk. mnt” 资 源 类 型 。Factory_Reset、Reboot 和 StartStatCollection 三 个 属性 中 
至 少 应 该 实现 一 个 。 
表 6-14 "oic, wk. mnt" 资 源 类 型 定义 
































属性 值 | 属性 值 访问 gw 
Ro ot: | 属性 名 类 型 | 标准 单位 模式 | 强制 描 xk 
当 写 该 属性 时 ,“0" 表 示 无 任何 指示 (初始 默认 值 " )， 
“1" 表 示 开 始 工厂 设 定 ; 在 工厂 重 设 后 ,该 值 会 恢复 
出 厂 重 设 fr | 布尔 型 读 写 | 是 | 到 初始 值 ,工厂 重 设 的 参数 和 数据 将 会 被 清理 。 当 读 
取 该 属性 时 , 值 “1" 表 示 待 恢复 的 出 厂 复位 ,否则 在 出 
厂 复位 后 该 值 为 “0” 
当 写 该 属性 时 ,“0" 表 示 无 任何 指示 (初始 默认 值 ); 
重启 rb | 布尔 型 读 写 | 是 |“1" 表 示 开 始 重启 ,重启 后 该 值 将 会 被 恢复 到 初始 值 
状态 , 且 重启 将 会 在 60s 内 结束 
“0" 表 示 无 任何 统计 资料 记录 ;“1" 表 示 开 始 进行 统 
开始 状态 收集 | sse | 布尔 型 读 写 | 是 | 计 ; 在 数据 采集 和 无 任何 终端 采集 设备 之 间 的 触发 
器 的 值 应 该 被 设 定 为 "0" 或 者 "1” 


ik. @ 默认 值 表示 设备 重新 启动 或 恢复 出 厂 设置 后 此 属性 的 值 。 


6.5 场景 


场景 是 某 些 自动 化 操作 的 机 制 。 一 个 场景 是 存储 资源 的 集合 ,是 一 组 定义 的 资源 属性 值 的 静态 实 
体 。 场 景 提 供 了 一 种 机 制 来 存储 由 多 个 独立 OCF 服务 器 端 托管 的 多 个 资源 设置 .一 旦 成 立 , 可 以 由 多 
个 客户 端 来 恢复 设置 。 场 景 可 以 分 组 和 重复 使 用 ,一 组 场景 也 是 一 个 场景 。 简 而 言 之 ,场景 是 用 户 捆绑 
设置 。 

1. 简介 

场景 是 通过 资源 来 描述 的 。 场 景 资源 由 OCF 的 服务 器 端 托管 ,最 高 级 别 资源 在 */oic/res” 上 。 这 
意味 着 ,OCF 客户 确定 场景 功能 是 通过 一 个 检索 */oic/res”? 或 资源 发 现 OCF 服务 器 端 上 的 承载 。 场 景 
的 设置 由 OCF 客户 端 交互 驱动 .包括 创建 新 的 场景 .这 是 场景 的 一 部 分 OCF 服务 器 端 资 源 属性 的 
映射 。 
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场景 功能 是 由 多 个 资源 创建 并 具有 如 图 6-11 所 示 的 结构 。 场 景 列表 场景 列表 
和 场景 集合 是 重 载 的 资源 集合 。 场 景 集合 包含 场景 的 列表 ,这 个 列表 包含 ipea 
零 个 或 多 个 场景 集合 。 场 景 成 员 资 源 包含 场景 和 控制 资源 之 间 的 映射。 URAZ 
2. 场景 建立 Smena 
想 要 创建 一 个 场景 ,OCF 客户 端 需要 验证 一 个 OCF 的 服务 器 端 支持 QNM 
场景 的 特征 ; 场景 成 员 不 需要 在 同一 OCF 服务 器 端 支持 该 特征 。 客 户 端 ie 
通过 检查 */oic/res" 和 包含 场景 列表 资源 进行 确认 ,如 图 6-12 所 示 , 将 场景 场景 成 员 Z2 
值 与 场景 资源 进行 映射 。 用 于 场景 集合 的 每 一 个 资源 映射 ,被 称 为 场景 成 场景 成 员 Zx 


员 资源 描述 。 该 场景 资源 包含 链接 资源 ,并 在 场景 值 属 性 中 列 出 , 巾 链接 ”图 6-11 通用 场景 资源 架构 
表示 OCF 实际 资源 属性 值 之 间 的 映射 。 


OCF 客 户 端 OCF 服 务 器 端 


检查 场景 支持 











检查 场景 列表 是 否 支持 





Get [/oic/res?rt-"oic.wk.sceneList"] 
- 








Links-"/myscenelist" 


建立 








在 场景 列表 中 创建 场景 集合 


Create[/myscenelist] 
{sceneColl,lastscene,scenevalues} 











场景 集合 "SceneColl" 加 入 
到 场景 列表 的 指针 中 去 








/myscenelist/myscenedescriptionl 


Create[/myscenedescriptionl] 
{href to resource. mapping info} 























在 sceneColl 中 创建 一 个 将 资源 创建 成 员 添加 到 
场景 映射 到 资源 属性 的 项 目 myscenedescription1 中 去 
~ /myscenedescriptionl 


6-12 ”检查 场景 支持 和 特定 场景 支持 的 交互 


3. 场景 互动 

具有 OCF 能 力 的 客户 端 可 以 与 场景 互动 。 允 许 的 场景 值 和 最 后 应 用 场景 值 可 以 从 托管 现场 OCF 
的 服务 器 端 进行 检索 。 现 场 值 应 通过 最 后 一 次 场景 属性 设置 .现场 值 通过 一 个 有 效 载荷 的 更 新 操作 来 
改变 。 这 些 步 骤 在 图 6-13 中 说 明 ,被 描述 的 最 后 一 次 场景 值 并 不 意味 着 是 场景 资源 当前 状态 的 映射 
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值 。 这 是 由 于 该 设置 现场 的 值 并 不 建 模 为 系统 的 实际 状态 。 这 意味 着 另 一 个 OCF 客户 端 可 以 改变 场 
景 的 值 ,只 是 资源 中 部 分 无 须 反 馈 场 景 状态 的 值 被 改变 。 


OCF 客 户 喘 |OCF 服 务 器 端 


交流 





























获取 当前 场景 值 f 





Get [/myscenedescription] 


返回 当前 场景 值 


设置 新 的 场景 值 J 


Update[/myscenedescription] 
{lastscene="new value") 








所 有 值 都 将 会 以 多 播 形式 在 服 
务 器 端 上 的 资源 中 进行 更 新 





场景 最 后 数据 返回 








图 6-13 在 特定 场景 下 的 客户 交互 
如 前 所 述 , 一 个 场景 可 引用 存在 于 一 个 或 多 个 OCF 服务 器 端的 一 个 或 多 个 资源 ,每 一 个 场景 发 生 
改变 时 重新 评估 。 这 个 评估 要 么 能 入 OCF 服务 器 端的 一 部 分 现场 .要 么 单独 通过 一 个 检索 操作 ,由 具 
有 识别 场景 的 OCF 客户 端 触发 ,观察 该 机 制 引用 的 资源 。 在 评估 过 程 中 的 新 场景 值 映 射 将 被 应 用 到 
OCF 服务 器 端 。 此 行为 如 图 6-14 所 示 。 


OCFE 客 户 中 OCHO GR T DEREN ‘OCF HI S 
URAR) 
ti 


在 OCF 服 务 器 端 上 的 协同 定 
位 嵌入 式 客户 端 











谈 取 当前 场景 值 











Get [/myscenedescription] 


一 
返回 最 近 一 个 场景 值 和 场景 值 属性 








设置 新 的 最 近 一 个 场景 的 值 属性 f 





Update[/myscenedescription] 


{lastscene="new value"] 




















位 查 所 有 场景 成 员 的 场景 仿 在 
服务 器 端 上 的 调用 、 更 新 
场景 最 后 数据 返回 更 新 OCF 服 务 器 端 OCH Bn 
{resource property="value"} |, tmesoureepropery value) — | 


确认 








6-14 ”由 于 一 个 场景 的 改变 可 能 发 生 的 交互 














86 «| OCF 技术 原理 及 物 联网 程序 开发 指南 


4. 一 个 场景 的 删除 

当 不 再 需要 场景 集合 时 ,最 终 用 户 可 以 从 OCF 服务 器 端 删除 场景 集合 。 由 于 场景 集合 是 OCF 集 
合 的 特殊 化 ,那么 它 是 通过 使 用 集合 删除 机 制 的 。 请 注意 ,这 也 将 删除 所 有 场景 资源 ,包括 场景 成 员 。 
删除 过 程 如 图 6-15 所 示 。 





OCF 服 务 器 端 





OCF 客 户 端 




















通过 从 顶层 资源 删除 的 方 
式 删除 myscenedescription1 








Delete /myscenelist?if-oic.if.Ib 






































meme d 
N 确认 
图 6-15 场景 资源 的 删除 
5. 对 于 场景 功能 定义 的 资源 类 型 概要 总 结 
表 6-15 汇总 了 部 分 场景 资源 类 型 。 
表 6-15 ”部 分 场景 资源 类 型 
人 性 化 名 称 资源 类 型 (rt) 简单 描述 
场景 列表 oic. wk. sceneList 包含 场景 集合 的 顶级 集合 
场景 集合 oic. wk. sceneCollection 零 个 或 多 个 场景 的 描述 
场景 成 员 oic. wk. sceneMember 场景 集合 中 每 个 特定 资源 部 分 的 映射 描述 
6. 安全 考虑 


在 具有 此 功能 的 服务 器 端 上 创建 场景 和 规则 ,取决 于 应 用 资源 的 接 人 控制 列表 和 具有 适当 权限 的 
客户 端 。 客 户 端 (嵌入 式 或 单独 的 ) 与 承载 被 引用 为 场景 成 员 或 规则 成 员 的 资源 服务 器 端 之 间 的 交互 ， 
取决 于 客户 端 是 否 具有 访问 主机 服务 器 上 的 资源 的 权限 。 

有 关 接 入 控制 列表 使 用 的 详细 信息 以 及 设备 身份 验证 的 相关 机 制 ,请 参阅 OCF 安全 性 ,以 确保 客 
户 端 有 访问 服务 器 端 上 的 规则 或 场景 成 员 资源 所 需 的 正确 权限 。 


6.6 图 标 


图 标 是 各 种 OCF 子 系统 所 需 的 原 语 , 例 如 桥接 。 一 种 可 选 的 资源 类 型 “oic. r. icon” 已 经 被 作为 图 
标 资源 的 公共 表达 给 设备 使 用 。 可 送 的 "icon 资源 如 表 6-16 所 示 。 
表 6-16 可 选 的 “icon" 资 源 























资源 类 型 相关 功能 
预定 义 URI 资源 类 型 ID ^" 接口 d xk 交互 
/ example/oic/icon icon oic. r. icon oic. if.r | 设备 可 以 通过 该 资源 获取 图 标 图 像 的 资源 图 标 
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K 6-17 详细 定义 了 *oic. r. icon" 资源 类 型 。 
表 6-17 "oic. r.icon” 资 源 类 型 定义 


mt 属性 名 属性 值 | 属性 值 单位 访问 | 是 否 描 述 








Mime #29 | mimetype SAP 指定 图 标的 格式 (媒体 类 型 )。 它 应 该 是 IANA 媒 



































读 | 是 | 体 类 型 中 指定 的 模板 字符 中 
宽度 width | S2 | >=1 读 | 是 | 图 标的 宽度 (以 像素 为 单位 ) 大 于 或 等 于 1 
高 度 height 整 型 | >=1 i | 是 | 图 标的 高 度 (以 像素 为 单位 ) 大 于 或 等 于 1 
图 标 media URI 读 是 | 用 于 定位 图 标 图 像 的 URI 
6.7 内 省 


内 省 是 宣布 在 设备 商 托管 资源 的 功能 机 制 。 内 省 设备 数据 的 预期 用 途 是 启用 动态 客户 端 。 例 如 ， 
可 以 使 用 内 省 设备 数据 的 客户 端 动态 生成 用 户 界 面 , 或 者 动态 地 将 托管 资源 翻译 创建 到 另 一 个 生态 系 
统 。 内 省 的 其 他 用 途 是 可 以 使 用 该 信息 来 生成 客户 端 代码 。 内 省 设备 数据 旨 在 扩大 线 上 已 有 的 数据 。 
这 意味 着 需要 使 用 现 有 的 机 制 来 全 面 了 解 在 设备 中 实现 的 内 容 。 例 如 ,内 省 设备 数据 不 表示 关于 观察 
的 信息 ,因为 已 经 使 用 “/oic/res” 中 链接 上 的 “p” 属 性 表示 了 该 信息 。 

内 省 设备 数据 推荐 作为 静态 数据 表示 。 这 意味 着 数据 在 设备 正常 运行 时 间 内 不 会 改变 。 然 而 , 当 
数据 不 是 静态 时 ,内 省 资源 将 指示 为 可 观察 的 ,并 且 *oic. wk. introspection” VER f]. URL 属性 值 应 更 改 
为 指示 内 省 设备 数据 已 更 改 。 

内 省 设备 数据 描述 组 成 的 资源 ,所 包含 资源 如 表 6-18 所 示 。 内 省 设备 数据 被 描述 为 JSON 格式 的 
Swagger2.0 文件 。Swagger2.0 文件 将 按照 以 下 定义 包含 资源 描述 。 

CD 内 省 设备 数据 中 的 资源 URL 不 应 具有 端点 描述 ,例如 , 它 不 应 该 是 一 个 完整 的 URL, 而 只 是 
来 自 端点 的 相对 路 径 , 相 对 路 径 应 与 */oic/res” 的 表达 相同 。 

(2)“/oic/res ”资源 不 应 该 被 列 在 内 省 设备 数据 中 。 

(3) 资源 “/oic/d”/oic/p” 和 安全 资源 允许 出 现在 内 省 设备 数据 中 ,但 不 是 必需 的 。 当 供应 商定 义 
或 可 选 资 源 应 用 了 ,那么 应 该 包括"/oic/d”*/oic/p”/oic/res” 和 安全 资源 。 

(4) 所 有 其 他 资源 必须 包含 在 内 省 设备 数据 中 。 

O 每 个 资源 将 会 包含 : 所 有 被 应 用 的 方法 ,所 支持 的 每 种 方法 中 应 用 的 查询 参数 ; 支持 接口 “if” 
作为 枚 举 值 ; 方法 中 的 请 求 和 响应 载体 方案 ,方案 数据 应 该 表示 为 Swagger 方案 。 

(6) 应 当 执 行 Swagger2.0 方案 : 它 是 完全 解决 方案 .在 Swagger2.0 文件 外 应 该 不 存在 任何 引用 ; 
方案 应 该 列 出 所 支持 的 接口 ; 方案 应 该 列 出 属性 是 可 选 的 还 是 必需 的 ; 方案 应 该 指出 属性 是 只 读 的 还 
是 可 读 写 的 ; 通过 属性 标记 ,默认 的 “rt" 属 性 应 当 被 用 于 指出 其 支持 的 资源 类 型 。 允 许 使 用 oneOf 和 
anyOf 结构 作为 Swagger2. 0 方案 的 一 部 分 。 

动态 资源 (例如 ,可 以 根据 客户 端 请 求 创建 的 资源 ) 的 URL 定义 中 应 该 包含 URL 标识 符 ( 例 如 使 
HORA). RA OHI URL 标识 资源 可 以 用 于 创建 整个 资源 组 。 实 际 路 径 中 可 以 包含 与 该 资源 相 链 
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接 的 集合 点 路 径 。 具 有 标识 符 的 URL 举例 如 下 。 
/SceneListResURI/{SceneCollect ionResURI} /{SceneMemberResURI} : 


当 人 允许 在 一 个 集合 内 创建 不 同 的 资源 类 型 时 ,那么 不 同 的 创建 方法 应 该 将 所 有 可 能 被 创建 的 资源 
类 型 都 进行 定义 。oneOf 的 结构 允许 使 用 可 选 资源 定义 模式 。oneOf 结构 允许 所 有 模式 进行 集成 , 现 
有 的 子 模式 可 以 用 于 表示 可 创建 资源 的 定义 ,如 下 所 示 。 
{ 
"oneOf" :[ 
{<< subschema 1 definition>>}, 
{<< sub schema 2 definition >>} 
] 
} 
使 用 内 省 设备 数据 的 客户 端 ,应 检查 设备 支持 的 内 省 设备 数据 版 本 。 每 个 文件 中 都 标明 Swagger 
版 本 ,标签 为 “swagger”。Swagger2.0 版 本 的 标签 示例 是 "swagger" :"2. 0"。 该 规范 的 较 新 版 本 可 能 会 
引用 Swagger 较 新 版 本 ,例如 Swagger3. 0。 
一 个 服务 器 端 将 支持 一 个 内 省 资源 ,资源 类 型 为 “oic. wk. introspection”, 如 表 6-18 所 定义 。 资 源 
类 型 为 “oic. wk, introspection” 的 资源 应 包含 在 资源 “/ oic / res". 





Ro 内 省 资源 
资源 类 型 相关 功能 
预定 义 URI | 资源 类 型 es 接口 描 xk His 
无 introspection | oic. wk. introspection | oic.if.r | 告知 内 省 文件 的 URL 的 资源 内 省 





K 6-19 定义 了 “oic. wk. introspection” Vt HA 70) 。 
表 6-19 “oic, wk. introspection” 资 源 类 型 定义 

















属 性 属性 名 pos pay 访问 模式 | 是 否 强制 描述 

URL 信息 | urlinfo 数组 读 是 对 象 数组 

URL url 字符 串 url 读 是 托管 负载 的 URL 

协议 protocol 字符 串 enum i 是 从 URL 检索 内 省 设备 数据 的 协议 
内 容 类 型 “| content-type | 字符 串 enum i E URL 的 内 容 类 型 

版 本 version 整 型 enum 读 否 内 省 协议 的 版 本 。 当 前 值 为 1 























内 省 设备 数据 检索 应 该 按照 以 下 步骤 进行 .如 图 6-16 所 示 。 
COD 检查 内 省 资源 是 否 支持 并 检索 资源 的 URL. 

(2) 检索 内 省 资源 的 内 容 。 

(3) 从 内 省 资源 中 指定 的 URL 上 下 载 内 省 设备 数据 。 

(4) 客户 端 使 用 内 省 设备 数据 。 
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OCF 客 户 端 OCF 服 务 器 端 




















检查 内 省 支持 一 一 一 一 | 一 一 








检查 oicwkintrospection 是 否 被 支持 df 





Get [/oic/res?rt-"oic.wk.introspection"] 
| 





Links="/myintrospectionresource" 


内 省 资源 的 使 用 





检索 内 省 资源 








Retrieve[/myintrospectionresource]{} 


/myintrospectionresource data 


现在 客户 端 知道 了 内 省 
设备 数据 的 URL 




















Retrieve[/myintrospectiondataurl] ( 


内 省 设备 数据 








图 6-16 检查 内 省 支持 以 及 下 载 内 省 设备 数据 的 交互 


内 省 设备 数据 的 使 用 一 一 一 一 一 


as OCF 中 的 消息 传递 


CHAPTER 7 








本 章 规定 每 种 协议 (如 CoAP HTTP 等 ) 的 消息 如 何 映射 为 CRUDN 消息 的 传递 操作 ,所 有 的 资源 
模型 属性 信息 应 在 消息 负载 中 承载 。 这 个 有 效 负载 应 在 资源 模型 层 中 产生 ,并 在 数据 连接 层 进行 封装 。 
除了 在 消息 收发 协议 中 定义 的 强制 报头 字段 规范 (如 CoAP HTTP) ,消息 头 仅 用 于 描述 该 消息 的 有 效 
载荷 (如 消息 有 效 负载 格式 )。 如 果 消 息 头 并 不 支持 此 功能 ,那么 这 些 信 息 也 应 在 消息 负载 中 携带 。 资 
源 模型 信息 不 应 包含 在 消息 头 结构 中 ,除非 消息 头 字段 是 消息 协议 规范 强制 的 。 


7.1 CRUDN 到 CoAP 的 映射 


一 个 OCF 设备 实施 CoAP 协议 ,应 符合 IETF RFC 7252 规定 的 方法 。 同 时 ,一 个 OCF 设备 实施 
CoAP 协议 ,应 符合 IETF 草案 实施 的 CoAP 观察 选项 。 对 于 CoAP 块 传输 的 支持 ,系统 规定 了 最 大 有 
效 载荷 MTU, 

如 果 在 请 求 者 通过 网 络 发 送 之 前 系统 是 不 安全 的 , 则 通过 将 方案 名 称 *oic” 替 换 为 “coap” 来 将 OCF 
的 URI 映射 到 CoAP 的 URI。 如 果 在 请 求 者 通过 网 络 发 送 之 前 系统 是 安全 的 , 则 通过 将 方案 名 称 *oic” 
替换 为 “coaps” 来 将 OCF 的 URI 映射 到 CoAPS 的 URI, 在 接收 侧 ,方案 名 称 被 替换 为 “oic”。 

7.1.1 具有 请 求 和 响应 的 CoAP 方法 

每 个 请 求 都 具有 实现 该 请 求 的 CoAP 方法 。 主 要 方法 及 其 含义 如 表 7-1 所 示 , 其 中 ,提供 如 何 映射 
传统 的 GET/PUT/POST/DELETE 方法 到 OCF 规范 中 的 CREATE/RETRIEVE/ UPDATE/ 
DELETE 操作 方法 。 使 用 这 些 操作 方法 ,相关 的 描述 提供 一 般 的 操作 行为 ,但 资源 的 接口 可 以 修改 这 
些 通用 语义 (默认 接口 体现 了 通用 语义 ) 及 其 通用 的 行为 。 

表 7-1 CoAP 主要 方法 及 其 含义 








用 于 CRUDN 的 方法 (强制 的 ) 请 求 数据 (强制 的 ) 响应 数据 
E 方法 代码 : GETO. 01) 响应 代码 : 成 功 (2. xX X ) 或 失败 (4. XX) 
用 于 检索 的 GET | 请 求 URI: 要 检索 资源 的 现 有 URI 负载 ,目标 资源 的 资源 表示 (成 功 时 ) 





方法 代码 : POSTO. 02) 

用 于 创建 的 POST 请 求 URI: 负责 创建 资源 的 现 有 URI 
负载 : 要 被 创建 资源 的 资源 表示 
方法 代码 : PUT(0.03) 

用 于 创建 的 PUT 请 求 URI: 要 被 创建 资源 的 新 URI 响应 代码 : 成 功 (2. X Xx ) 或 失败 (4. XX) 
负载 : 要 被 创建 资源 的 资源 表示 


响应 代码 : 成 功 (2. X Xx) 或 失败 (4. XX) 
负载 : 新 创建 资源 的 URI( 成 功 时 ) 
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续 表 





用 于 CRUDN 的 方法 (强制 的 ) 请 求 数据 (强制 的 ) 响应 数据 
方法 代码 : POSTO. 02) 
用 于 更 新 的 POST 请 求 URI: 将 被 部 分 更 新 的 资源 的 现 有 URI 响应 代码 : 成 功 (2. X Xx ) 或 失败 (4. XX) 
负载 : 要 被 部 分 更 新 资源 的 (部 分 ) 资 源 表示 
方法 代码 : PUTCO. 03) 

用 于 更 新 的 PUT 请 求 URI: 要 被 完全 蔡 换 资源 的 现 有 URI 响应 代码 : 成 功 (2. XXX ) 或 失败 (4. XX) 
负载 : 要 被 更 新 资源 的 资源 表示 
方法 代码 : DELETE(0. 04) 


用 于 删除 的 DELETE YOR URL: 要 被 删除 资源 的 现 有 URI 响应 代码 : 成 功 (2. X X ) 或 失败 (4. XX) 




















1. 通过 POST/PUT 进行 OCF 的 创建 

本 节 介绍 如 何 使 用 POST 或 者 PUT 方法 创建 OCF 的 相关 资源 。 

1) 通过 POST 进行 OCF 的 创建 

POST 仅 在 请 求 URI 有 效 的 情况 下 使 用 ,也 就 是 说 , 它 是 正在 处 理 请 求 服务 器 端 现 有 资源 的 URI。 
如 果 不 存在 这 样 的 资源 , 则 服务 器 端 将 以 4. X x 的 错误 代码 进行 响应 。 通 过 POST 进行 OCF 的 创建 
将 使 用 的 现 有 请 求 URI, 它 负责 创建 服务 器 端的 资源 。 创 建 的 资源 URI 由 服务 器 端 确定 ,并 在 响应 中 
提供 给 客户 端 。 

客户 端 应 在 请 求 有 效 载 荷 中 包括 新 资源 的 表示 。 有 效 载荷 中 新 资源 的 表示 应 具有 创建 有 效 资源 实 
例 的 所 有 必要 属性 , 即 所 创建 的 资源 应 能 够 正确 响应 具有 强制 接口 的 有 效 请 求 (例如 ,GET with? if — 
oic. if. baseline) 。 

一 旦 接收 到 POST 请 求 ,服务 器 端 会 执行 以 下 操作 之 一 : 使 用 新 的 URI 创建 新 的 资源 ,使 用 新 创 
建 资源 的 URI 和 成 功 响应 代码 (2, X X) 进 行 响应 ; 错误 响应 代码 (4. XX, POST 是 不 安全 的 ,是 无 
法 预期 或 保证 寡 等 行为 时 支持 的 方法 。 

2) 通过 PUT 来 创建 

PUT 被 用 于 创建 一 个 新 的 资源 或 完全 替代 一 个 已 存在 资源 的 完整 表示 。 在 PUT 请 求 的 负载 中 ， 
资源 的 表示 应 该 是 完整 的 表示 。 通 过 PUT 来 创建 应 该 使 用 一 个 新 的 请 求 URI 来 标识 要 创建 的 新 

有 效 载荷 中 的 新 资源 表示 ,应 具有 要 创建 有 效 资源 实例 的 所 有 必要 属性 , 即 所 创建 的 资源 应 能 够 使 
用 强制 接口 对 有 效 请 求 进行 正确 响应 (例如 ,GET with? if —oic. if. baseline) 

一 旦 接收 到 PUT 请 求 ,服务 器 端 会 执行 以 下 操作 之 一 : 创建 具有 PUT 请 求 中 提供 请 求 URI 的 新 
资源 ,并 发 回 具有 成 功 响应 代码 (2. x Xx ) 的 响应 ; 错误 响应 代码 (4. XX), PUT 是 一 种 不 安全 的 方 
法 ,但 它 是 宕 等 的 ,因此 , 当 重 复 PUT 请 求 时 ,每 次 的 结果 是 相同 的 。 

2. 使 用 GET 进行 OCF 的 检索 

GET 可 以 用 于 检索 操作 ,GET 方法 检索 由 请 求 URI 标识 的 目标 资源 表示 。 一 旦 接收 到 GET 请 
求 ,服务 器 端 会 执行 以 下 操作 之 一 : 使 用 成 功 响 应 代码 (2. x Xx ) 发 回 有 具有 目标 资源 表示 的 响应 ; 错误 响 
应 代码 (4. ox X ) 或 忽略 它 ( 例 如 不 适用 的 多 播 GET). GET 是 一 种 安全 的 方法 ,是 知 等 的 。 

3. 使 用 POST 进行 OCF 的 更 新 

POST 仅 在 请 求 URI 有 效 的 情况 下 使 用 ,也 就 是 说 , 它 是 正在 处 理 请 求 服务 器 端 现 有 资源 的 URI 
如 果 不 存在 这 样 的 资源 , 则 服务 器 端 将 以 4. X X 的 错误 响应 代码 进行 响应 。 客 户 端 应 该 使 用 POST 用 
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于 现 有 资源 的 部 分 更 新 ,此 时 有 效 载荷 包含 了 目标 资源 的 一 部 分 属性 。 

一 旦 接收 到 POST 请 求 .服务 器 端 会 执行 以 下 操作 之 一 : 根据 使 用 的 接口 将 请 求 应 用 于 由 请 求 
URI 标识 的 资源 ( 即 忽 略 不 存在 属性 的 POST) .并 发 回 具有 成 功 响应 代码 (2. XxX X ) 的 响应 ; 错误 响应 
代码 (4. X X)。 注 意 ,如 果 有 效 载荷 中 的 表示 与 使 用 所 应 用 接口 的 POST 目标 资源 不 兼容 ( 即 由 于 有 效 
载荷 中 的 只 读 属 性 ,“ 覆 盖 " 语 义 不 能 被 执行 ), 则 会 返回 错误 响应 代码 4. X X 。POST 是 一 种 不 安全 的 
方法 ,是 无 法 预期 或 保证 竹 等 行为 时 支持 的 方法 。 

4. 使 用 DELETE 进行 OCF 的 删除 

DELETE 用 于 OCF 的 删除 操作 。DELETE 方法 请 求 删除 由 请 求 URI 标识 的 资源 。 一 旦 接收 到 
删除 请 求 ,服务 器 端 会 执行 以 下 操作 之 一 : 删除 目标 资源 并 发 回 具 有 成 功 响应 代码 (2. X Xx ) 的 响应 ; 错 
误 响 应 代码 (4. XX), DELETE 是 一 种 不 安全 的 方法 ,但 它 是 每 等 的 (除非 URI 被 重新 用 于 新 实例 ) 。 


7.1.2 内容 类 型 


该 OCF 设备 框架 任务 支持 CBOR ,如果 支 持 多 于 一 种 编码 类 型 (CBOR 或 者 JSON) ,由 一 个 实现 支 
持 , 它 允许 有 效 载荷 体 协商 。 在 这 种 情况 下 ,在 下 TF RFC 7252 中 定义 的 接收 选项 ,应 被 用 来 表示 OCF 
客户 端 请 求 的 内 容 格式 。 支 持 的 内 容 格式 如 表 7-2 所 示 。 
表 7-2 ”OCF 支持 的 内 容 格式 


媒体 类 型 ID 媒体 类 型 ID 
application/cbor 60 application/vnd. ocf+cbor 10000 





客户 端 应 在 有 效 载 荷 的 消息 中 包括 内 容 格式 选项 。 服 务 器 端 应 包含 一 个 内 容 格 式 选 项 ,用 于 所 有 
成 功 (2. x X ) 响 应 与 有 效 载荷 主体 。 根 据 IETF RFC 7252, 服 务 器 端 应 包含 与 有 效 载荷 主体 的 所 有 错 
误 (4. XX 或 5. XX) 响应 的 内 容 格式 选项 ,除非 它们 包括 诊断 有 效 载荷 ; 诊断 有 效 载 荷 的 错误 响应 不 
包括 内 容 格式 选项 。 内 容 格式 选项 应 使 用 表 7-2 中 的 ID 列 数 值 。OCF 可 以 直接 授权 特定 的 内 容 格 式 
选项 。 

客户 端 还 应 在 每 个 请 求 消息 中 包含 接收 选项 。 接 收 选项 应 指示 响应 消息 在 表 7-3 中 定义 的 所 需 内 
容 格式 。 服 务 器 端 应 返回 所 需 的 内 容 格式 (如 果 可 用 ) .如 果 不 能 返回 所 需 的 内 容 格式 , 则 服务 器 端 将 使 
用 适当 的 错误 消息 进行 响应 。 

服务 器 端 、 客 户 端的 请 求 和 相应 消息 应 该 包含 OCF 内 容 格式 版 本 。 客 户 端 应 在 请 求 消息 中 包含 
OCF 接收 内 容 格式 版 本 。OCF 内 容 格式 版 本 和 OCF 接收 内 容 格 式 版 本 在 CoAP 头 中 指定 为 选项 号 
码 , 如 表 7-3 所 示 。 

表 7-3 OCF 内 容 格式 版 本 和 OCF 接收 内 容 格式 版 本 的 选项 号 码 











CoAP 选项 号 码 名 R 格 x 长 度 / 字 节 
2049 OCF 接收 内 容 格式 版 本 uint 2 
2053 OCF 内 容 格 式 版 本 uint 2 














OCF 内 容 格式 版 本 和 接收 内 容 格式 版 本 的 值 是 2 字 节 长 度 的 无 符号 整 型 数 ,用 来 定义 主要 版 本 、 
次 要 版 本 以 及 副 版 本 。 主 要 版 本 和 次 要 版 本 占据 5 位 , 副 版 本 占据 6 位 ,如 表 7-4 所 示 。 表 7-5 解释 了 
几 个 实例 。 





O AS corer Qe s 


表 7-4 OCF 接收 内 容 格式 版 本 和 OCF 内 容 格式 版 本 表示 
主要 版 本 次 要 版 本 副 版 本 
位 |15 | 14 | 13 | 12 | 11 | 10 | 9 8 7 6 5 4 3 2 1 



























































表 7-5 OCF 内 容 格式 版 本 和 OCF 接收 内 容 格式 版 本 表示 的 实例 

















OCF 版 本 二 进 制 表示 整 型 值 
1.0.0 0000100000000000 2048 
1.1.0 0000100001000000 2112 





fE OCF 1. 0 版 本 中 的 OCF 接收 内 容 格式 版 本 和 OCF 内 容 格式 版 本 应 该 是 1. 0. 0( 如 
0B0000100000000000) 。 

为 了 实现 本 规范 中 不 同 版 本 设备 之 间 的 兼容 性 .设备 应 遵循 如 图 7-1 所 示 的 策略 。 所 有 设备 都 应 
该 支持 现在 的 、 以 往 所 有 的 内 容 格式 选项 和 版 本 。 客 户 端 应 该 发 送 带 有 所 有 版 本 内 容 格式 的 发 现 请 求 
消息 ,直到 其 发 现 所 有 在 网 络 中 的 服务 器 端 。 


GET /oic/res with application/cbor 














OCF 1.1 OCF 1.1 
客户 端 服务 器 端 
Joic/res response per OCF 1.1 
GET /oic/res with application/cbor — f 
OCF 1.1 *| ocF1X 
客户 端 服务 器 端 
Return /oic/res per OCF 1.1 


7 — — —^ GET /oic/res with application/vnd.ocf*cbor(— — — — ^ 
OCF 1X “| OCF LI 
客户 端 | 服务 器 喘 

Return an error 


= GET /oic/res with application/cbor — (— — — 
OCF LX =| OCF Ll 
客户 端 | 服务 器 喘 

— Return /oic/res per OCF 1.1 e 














GET /oic/res with application/vnd.ocf*cbor 
-— 





























Toic/res response per OCF 1.0 


图 7-1 内 容 格式 策略 


7.1.3 CoAP 响应 代码 及 块 传输 


CRUDN 操作 响应 代码 到 CoAP 响应 代码 的 映射 与 IETF RFC 7252 中 定义 的 响应 代码 相同 。 
基本 CoAP 消息 的 小 型 有 效 载荷 是 典型 的 轻 量 级 , 受 限 于 物 联 网 设备 的 正常 工作 。 但 是 有 些 情景 
应 用 程序 需要 传输 大 量 的 有 效 载荷 。 如 IETF 定义 CoAP 逐 块 传输 ,OCF 所 有 服务 器 端 使 用 处 理 任 何 
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定义 CRUDN 操作 的 结果 ,其 生成 内 容 的 有 效 载荷 将 超过 CoAP 数据 包 的 大 小 。 

同样 ,如 果 IETF 定义 CoAP 逐 块 传输 应 由 OCF 所 有 客户 端 支持 。 利 用 块 传输 有 效 载荷 以 及 有 效 
载荷 超过 一 个 CoAP 数据 块 大 小 的 传输 ,两 者 均 可 以 接收 。 正 在 使 用 该 机 制 传输 的 单个 实例 发 送 所 有 
块 ,都 应 具有 相同 的 可 靠 性 设 定 ( 即 可 确定 或 可 证 实 ) 。 

由 IETF 描述 的 OCF 的 客户 端 可 同时 支持 块 1( 描 述 性 ) 和 块 2( 对 照 ) 选 项 。 一 个 OCF 服务 器 端 
可 以 同时 支持 块 1( 对 照 ) 和 块 2( 描 述 性 ) 的 选项 。 


7.2 CoAP 序列 通过 TCP 


在 TCP 已 经 可 用 的 环境 中 .可 以 利用 CoAP 提供 的 可 靠 性 。 此 外 ,在 某 些 环境 中 UDP 流量 被 阻 
挡 , 因 此 ,部 署 可 能 使 用 TCP 协议 。 例 如 ,考虑 云 应 用 程序 充当 客户 端 OCF, OCF 服务 器 端 位 于 用 户 的 
家 中 。 它 已 经 支持 CoAP 作为 消息 传递 协议 OCF 的 服务 器 端 (例如 ,智能 家 居 垂 直 应 用 ) ,可 以 很 容易 
地 支持 CoAP 序列 通过 TCP, 而 不 是 添加 另 一 种 消息 传递 协议 。 一 个 OCF 设备 通过 TCP 实现 序列 化 
CoAP 应 符合 IETF 规范 。 

如 果 UDP 受阻 ,客户 端 依赖 于 设备 上 预先 配置 的 详细 信息 ,找到 TCP 的 CoAP 支持 。 如 果 UDP 
没有 受阻 ,支持 CoAP 序列 化 通过 TCP 的 OCF 设备 ,应 在 */oic/res” 的 “mpro” 消 息 协 议 属性 中 填充 
“coap 十 tcp” 或 “coaps 十 tcp” 来 表示 该 设备 支持 的 消息 协议 。 

OCF 客户 端 和 OCF 服务 器 端 之 间 传 输 的 消息 类 型 应 该 是 一 个 非 确定 消息 。 在 此 方案 中 使 用 的 协 
议 栈 ,应 在 IETF 规范 中 叙述 。 所 使 用 的 URI 方案 应 当 在 IETF 规范 中 定义 。IETF RFC 7301 描述 了 
对 于 “coaps 十 tcp” 使 用 的 URI 方 案 一 一 TLS 应 用 层 协议 协商 扩展 。 

为 了 确保 一 个 设备 保持 连接 ,使 用 CoAP 序列 通过 TCP, 发 起 连接 的 设备 应 该 发 送 应 用 层 
KeepAlive 消息 .支持 应 用 层 的 KeepAlive 的 理由 如 下 : TCP KeepAlive 只 能 保证 一 个 连接 始终 存在 于 
网 络 层 , 而 不 是 在 应 用 层 ; TCP KeepAlive 的 间隔 配置 只 能 用 内 核 参数 ,并 取决 于 操作 系统 (例如 ,在 
Linux 中 默认 情况 是 2h) 。 

支持 通过 TCP 的 CoAP 应 当 使 用 下 面 的 KeepAlive 机 制 。 一 个 OCF 服务 器 端 应 支持 表 7-6 定义 
的 资源 类 型 为 "ping” 的 资源 。 


表 7-6 “oic. wk. ping" Xt iR 























. 资源 类 型 相关 的 功能 
预定 义 URI RM | peep | 2T Hook pu 
/ oic/ pini in oic. wk. pin oic. if. rw 客户 端 使 其 与 服务 器 端的 连接 保持 活 KeepAlive 
ping ping - . ping. ao 动 状态 的 资源 Pp. 





K 7-7 定义 了 “oic. wk. ping” 资 源 类 型 。 

表 7-7 "oic. wk. ping "资源 类 型 定义 
属性 值 | 属性 值 访问 是 否 
属 性 属性 名 类 型 规则 单位 模式 强制 d 述 
间隔 in 整 型 min 读 写 是 连接 保持 活动 和 未 关闭 的 时 间 间 隔 
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下 列 步骤 详细 描述 了 客户 端 和 服务 器 端的 KeepAlive 机 制 。 

CD 客户 端 希望 保持 与 OCF 服务 器 端的 连接 状态 ,应 在 OCF 的 服务 器 端 更 新 其 连接 时 间 间 隔 上 
发 送 一 个 POST 请 求 到 */oic/ping” 的 资源 。 本 时 间 间 隔 应 开始 为 2min, 并 以 2 的 倍数 增加 ,最 多 用 时 
64min, 然 后 停留 在 64min 。 

(2) 一 个 OCF 服务 器 端 接收 到 请 求 应 在 Lmin 内 做 出 回应 。 

G) 如 果 OCF 客户 端 未 能 在 lmin 内 收 到 答复 ,应当 终 止 连接 。 

(4) 在 指定 的 时 间 间 隔 内 ,如 果 OCF 服务 器 端 没 有 收 到 POST 请 求 到 “ping" 的 资源 ,OCF 服务 器 
端 将 终止 连接 。 


7.3 CBOR 中 的 负载 编码 


OCF 实现 将 根据 IETF RFC 7049 执行 从 JSON 定义 的 模式 到 CBOR 的 转换 以 及 从 CBOR 到 
JSON 的 转换 ,除非 在 规范 中 另 有 规定 。 

定义 为 JSON 整数 的 属性 应 在 CBOR 中 编码 为 整数 (CBOR 主要 类 型 0 和 1)。 定 义 为 JSON 数字 
的 属性 应 编码 为 整数 . 单 精度 浮 点 数 或 双 精度 浮 点 数 (CBOR 主要 类 型 7, 子 类 型 26 和 27); 选择 是 依赖 
于 实现 的 。 不 应 使 用 单 精度 浮 点 数 (CBOR 主要 类 型 7, 子 类 型 25)。 整 数 的 闭合 范围 为 [一 28 ,2 ] 。 
定义 为 JSON 数字 的 属性 应 尽 可 能 编码 为 整数 ; 如 果 不 能 ,在 精度 损失 不 影响 服务 质量 的 情况 下 ,定义 
为 JSON 数字 的 属性 应 该 使 用 单 精度 ,否则 属性 将 使 用 双 精 度 。 

在 接收 到 CBOR 有 效 载荷 时 ,实现 应 该 能 够 在 任何 位 置 解释 CBOR 整数 值 。 如 果 定 义 为 JSON 整 
数 的 属性 接收 到 的 编码 不 是 整数 ,那么 实现 可 以 使 用 适用 于 底层 传输 的 最 终 响应 (例如 CoAP 为 4. 00， 
HTTP 为 400) 拒 绝 此 编码 ,因此 需要 对 整数 情况 进行 优化 。 如 果 一 个 属性 被 定义 为 一 个 JSON 数值 ， 
则 实现 应 该 接收 整数 . 单 精度 浮 点 数 和 双 精 度 浮 点 数 。 
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CHAPTER 8 








本 章 通过 描述 参与 实体 间 的 一 系列 操作 ,来 说 明 OCF 的 场景 实例 ,包括 OCF 交互 场景 与 部 署 模 
型 .其 他 资源 模型 与 OCF 的 映射 。 


8.1 OCF 操作 例 程 


本 节 描 述 一 个 参与 实体 操作 的 场景 。 在 例子 中 ,“Light" 是 一 个 OCF 服务 器 端 ,智能 手机 ?是 一 个 
OCF 客户 端 。 在 环境 中 ,“Garage” 也 是 OCF 服务 器 端 。 所 有 例子 都 遵循 以 下 示例 资源 类 型 定义 : 
“oic. example. light”, 如 表 8-1 ras. 

表 8-1 "oic. example. light" 资 源 类 型 定义 
属性 值 | 属性 值 访问 是 否 








属 ”性 | 属性 名 xm 规则 单位 模式 Be d g 

名 称 n 字符 串 读 写 5 

开关 of 布尔 型 读 写 是 on/off 控制 : O=off,1=on 
调 光 器 dm 整 型 0 一 255 读 写 是 该 资源 的 取 值 范围 为 [0,255] 





"oic. example. garagedoor” 资 源 类 型 定义 ,如 表 8-2 所 示 。 
表 8-2 "oic. example. garagedoor” 资 源 类 型 定义 


Roc 属性 名 属性 值 | 属性 值 单位 访问 是 否 Bo 
































类 型 规则 模式 强制 
名 称 n 字符 串 读 写 5 
开关 oc 布尔 型 读 写 是 open/close 控制 : 0—open.1-— close 





"F ifii ff] PA A“ /oic/mon" C rt — 0c. wk. mon") RI" /oic/mnt" (“rt — oc. wk. mnt”) 在 资源 模型 中 
定义 。 在 家 用 智能 手机 中 打开 单个 灯 , 如 图 8-1 Bros ,这 个 序列 强调 了 OCF 智能 手机 对 OCF 灯 资 源 的 
发 现 和 控制 。 

发 现 请 求 可 以 发 送 给 CoAP 多 播 地 址 224. 0. 1. 187 或 者 可 以 直接 发 送 给 管理 灯 资 源 设备 的 IP 
地 址 。 

(1) 智能 手机 发 送 一 个 GET 请 求 给 “/oic/res” 资 源 来 发 现 目标 终端 控制 的 所 有 资源 。 

D 终端 (灯泡 ?用 资源 URI、 资 源 种 类 和 该 终端 支持 的 接口 作为 应 答 ( 其 中 一 个 资源 是 /light”， 


*rt—oic. example. light”). 
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O 智能 手机 发 送 一 个 GET 请 求 给 “/light" 从 而 了 解 其 现在 的 状态 。 终 端 用 光 资 源 的 表示 来 应 答 
({n=bedlight; of =0}), 

(4) 智能 手机 通过 发 送 一 个 POST 请 求 给 */light" 资 源 来 改变 光 资 源 的 “of" 特 性 ({of 一 1) ) 。 

(5) 一 旦 该 请 求 成 功 执行 ,终端 用 改变 的 资源 表示 来 回应 ; 否则 ,返回 错误 代码 。 错 误 代码 的 细节 
在 消息 中 定义 。 

图 8-2 强调 了 检测 和 维护 的 设备 管理 功能 。 前 提 条 件 是 管理 设备 具有 不 同 的 安全 权限 ,因此 ,可 以 
在 该 OIC 执行 设备 管理 操作 。 

(1) 管理 设备 发 送 一 个 GET 请 求 给 "/oicy/res? 资 源 去 发 现 目标 终端 的 所 有 资源 (在 这 个 例子 中 是 
灯泡 ) 。 

(2) 终端 (灯泡 ) 用 资源 URI、 资 源 类 型 和 终端 支持 的 接口 应 答 ( 其 中 一 个 资源 是 /oic/mon”, “rt 二 
oc. wk. mon” 目 另 一 个 资源 是 /oic/mnt”,“rt 二 oc. wk. mnt"), 

G) 在 看 见 终端 数据 之 后 ,管理 设备 通过 发 送 POST 请 求 给 “/oic/mnt" 资 源 ({fr 二 1}) 来 改变 维修 
资源 的 “fr" 特 性 ,触发 了 终端 (灯泡 ) 的 恢复 出 厂 设 置 。 

(4) 一 旦 请 求 被 成 功 执行 ,终端 用 改变 了 的 资源 表示 来 回应 ; 否则 ,将 返回 错误 代码 。 错 误 代码 的 
细节 在 消息 中 定义 。 


智能 手机 灯泡 管理 设备 灯泡 
(OcF 客 户 端 | (OCF 服 务 器 端 ) (OCFA Pi) (OCF 服 务 器 喘 ) 

































































GET(oic/res) GET(oic/res) 
M-------------4 I[O---2-------4 
response(list[res uri,rt,if]) response 
(list[res uri,rtif]) 
GET(/light) GET(/oic/mon) av-l 
E——— — | 1t73000 
EPEA A dssssss 
response(content) response(content) 
POST(/light. {of=1}) POST(/oic/mnt. {fr=1}) 
EEA PORER S fr=1 
success/failure success/failure 
图 8-1 在 家 用 智能 手机 打开 单个 灯 8-2 设备 管理 (检测 和 维护 ) 


8.2 OCF 交互 场景 与 部 署 模型 


一 个 OCF 客户 端 连接 一 个 或 多 个 OCF 服务 器 端 ,以 便于 访问 这 些 OCF 服务 器 端 提 供 的 资源 。 
图 8-3 表示 OCF 角色 之 间 可 能 交互 的 场景 。 

在 这 个 场景 中 ,OCF 客户 端 和 OCF 服务 器 端 直接 交流 .不 用 其 他 任何 OCF 设备 的 参与 。 例 如 ,一 
个 控制 执行 器 的 智能 手机 直接 使 用 这 个 场景 。 

OCF 客户 端 和 使 用 另 一 个 OCF 服务 器 端的 OCF 服务 器 端的 交互 .如 图 8-4 所 示 。 在 这 个 场景 中 ， 
需要 另 一 个 OCF 服务 器 端 提供 所 需要 的 支持 ,OCF 客户 端 直接 访问 一 个 特定 OCF 服务 器 端的 资源 。 
这 个 场景 应 用 中 , 当 一 个 智能 手机 首先 访问 了 一 个 发 现 服务 器 端 ,找到 特定 应 用 程序 的 寻 址 信息 ,然后 
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直接 访问 应 用 程序 进行 控制 。 
OCF 服 务 器 端 | 
OCF 服 务 器 端 OCF 客 户 端 OCF 服 务 器 端 OCF 客 户 端 | 
图 8-3 服务 器 端 和 客户 端 之 间 的 直接 交互 图 8-4 客户 端 和 使 用 另 一 个 服务 器 端 间 的 交互 


OCF 客户 端 和 使 用 OCF 中 介 , 与 OCF 服务 器 端 进行 交互 ,如 图 8-5 所 示 。 在 这 个 场景 中 ,一 个 
OCF 中 介 连 接 了 OCF 客户 端 和 OCF 设备 之 间 的 交互 ,通过 代理 ,控制 智能 家 居 电 器 ,智能 手机 使 用 这 
个 场景 。 

使 用 多 个 OCF 服务 器 端 和 中 介 OCF 客户 端 和 OCF 服务 器 端 之 间 的 交互 如 图 8-6 所 示 。 在 这 个 
场景 中 ,OCF 服务 器 端 和 OCF 中 介 角 色 是 用 来 促进 OCF 客户 端 与 一 个 特定 OCF 服务 器 端的 交互 。 
在 实际 场景 中 ,智能 手机 首先 访问 资源 目录 服务 器 端 去 找到 特定 家 用 电器 的 地 址 ,然后 利用 代理 给 该 家 
用 电器 传递 命令 消息 。 该 智能 手机 可 以 利用 资源 目录 中 定义 的 机 制 (例如 ,默认 位 置 . 多 播 地 址 或 者 


DHCP) 去 发 现 资源 目录 信息 。 
Ce o] 






























































OCF 服 务 器 端 OCF 中 介 OCF 客 户 端 
OCF 服 务 器 端 OCF 中 介 OCF 客 户 端 OCF 服 务 器 端 LJ 
图 8-5 客户 端 使 用 中 介 与 服务 器 端的 交互 图 8-6 客户 端 和 使 用 多 个 服务 器 支持 的 服务 器 端的 交互 


在 OCF 部 署 中 ,OCF 设备 通过 有 线 、 无 线 来 部 署 和 交互 。OCF 设备 是 有 着 资源 的 物理 实体 ,并 且 
承担 着 一 个 或 多 个 OCF 角色 。 部 署 的 结构 和 OCF 设备 数量 是 没有 约束 的 。OCF 结构 是 灵活 的 ,可 扩 
展 的 ,能 解决 大 量 有 着 不 同 能 力 的 设备 ,包括 有 限 内 存 和 容量 受 限 设 备 。 图 8-7 描述 了 一 个 典型 的 OCF 
部 署 和 一 套 OCF 设备 ,可 分 为 以 下 几 类 。 





基础 设施 
服务 器 


执行 器 p 
传感器 


智能 标牌 | 
































图 8-7 设备 示例 
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物体 : 能 够 与 物理 环境 接口 的 网 络 设备 ,是 主要 被 控制 和 监测 的 设备 ,如 智能 家 电 、 传 感 器 以 及 执 
行 器 。 物 体 大 部 分 都 承担 OCF 服务 器 端的 角色 ,也 承担 OCF 客户 端的 角色 ,例如 ,在 机 器 对 机 器 的 通 
信 中 。 

用 户 设备 : 被 用 户 使 用 的 设备 .允许 用 户 区 访问 资源 和 服务 ,如 智能 手机 、 笔 记 本 电脑 和 其 他 穿戴 
式 设备 。 用 户 设备 主要 承担 OCF 客户 端的 角色 ,但 也 承担 OCF 服务 器 端 和 OCF 中 介 的 角色 。 

服务 器 网 关 : 承担 OCF 中 介 的 网 络 设备 ,如 家 庭 网 关 。 

基础 设施 服务 器 : 驻 留 在 云 基 础 设备 的 数据 中 心 ,通过 提供 网 络 服务 ,如 AAA, NAT 遍历 ,来 促进 
OCF 设备 之 间 的 交互 。 


8.3 其 他 资源 模型 与 OCF 映射 


本 节 主 要 包括 多 资源 模型 支持 多 资源 模型 的 OCF 方法 资源 模型 指示 以 及 配置 文件 实例 。 


8.3.1 多 资源 模型 


RESTful 交互 是 依赖 于 资源 模型 定义 的 。 因 此 ,为 了 互 操作 性 ,OCF 设备 需要 对 资源 模型 有 共同 
的 理解 。 不 同 的 组 织 ( 包 括 OCF、IPSO 和 oneM2M 联盟 ) 定 义 了 多 种 资源 模型 ,并 且 将 其 用 在 工业 中 。 
这 限制 了 各 自生 态 系统 之 间 的 互 操作 性 。 不 同 资源 模型 的 差别 如 下 。 

(1) 资源 结构 : 资源 被 定义 为 拥有 属性 (如 oneM2M) ,或 被 定义 为 一 个 原子 实体 并 且 不 可 以 被 分 解 
为 属性 (如 IPSO) 。 例 如 ,智能 灯 可 以 表示 为 有 开关 属性 的 资源 或 者 一 个 包括 开关 资源 的 集合 。 前 者 的 
开关 属性 没有 自己 的 URI, 并 且 只 可 以 通过 这 个 资源 来 间接 访问 。 而 后 者 本 身 成 为 一 个 资源 ,开关 资源 
被 分 配 了 自己 的 URI 并 且 可 以 被 直接 操作 。 

(2) 资源 名 称 和 种 类 : 资源 可 以 允许 自由 地 命名 . 且 用 不 同 的 资源 类 型 属性 来 表明 它 的 特性 (如 
oneM2M) 。 但 是 .有 的 组 织 就 预先 固定 了 资源 的 名 称 , 用 名 字 本 身 去 表明 其 特性 (如 IPSO)。 例 如 , 智 
能 灯 可 以 在 oneM2M 中 被 命名 为 *LivingRoomLight_1”, 但 是 IPSO 联盟 是 具有 固定 的 物体 名 称 和 物体 
ID 的 ,例如 *IPSO Light Control(3311)”。 结 果 是 ,URI 的 数据 路 径 ,oneM2M 使 用 自由 定义 ,而 IPSO 
使 用 预先 定义 。 

(3) 资源 分 层 : 一 些 允许 资源 按 分 层 来 管理 ,以 便于 一 个 资源 本 身 可 以 包括 其 他 资源 ,以 一 种 父子 
关系 (如 oneM2ND ; 其 他 的 联盟 以 扁平 结构 来 托管 资源 ,只 能 通过 应 用 其 链接 来 访问 其 他 资源 。 

除了 以 上 不 同 之 外 ,不 同 的 组 织 用 不 同 的 语法 ,并 且 定 义 不 同 的 特性 (例如 资源 接口 ) ,这 将 抑制 物 
联网 的 互 操 作 性 。 


8.3.2 支持 多 资源 模型 的 OCF 方法 


为 了 拓展 物 联 网 生态 系统 ,OCF 架构 采用 包容 的 方法 来 促进 现 有 的 资源 模型 之 间 的 互通 。 具 体 来 
说 ,OCF 架构 定义 了 OCF 资源 模型 ,同时 也 提供 了 一 种 机 制 , 可 以 将 该 资源 模型 映射 到 其 他 模型 。 通 
过 包容 现 有 的 资源 模型 .OCF 包容 现 有 的 生态 系统 ,上 且 在 向 所 有 生态 系统 的 资源 模型 过 渡 。 下 面 的 
OCF 特性 实现 了 对 其 他 资源 模型 的 支持 。 

(D OCF 资源 模型 是 多 个 模型 的 超 集 : OCF 资源 模型 被 定义 为 现 有 资源 模型 的 超 集 。 换 句 话 说 ， 
任何 现存 的 资源 模型 可 以 被 映射 为 OCF 资源 模型 概念 的 子 集 。 

(2) OCF 框架 允许 资源 模型 协商 : OCF 客户 端 和 服务 器 端 交换 各 自 支持 的 资源 模型 信息 。 基 于 交 














100 去 | OCF 技 术 原理 及 物 联网 程序 开发 指南 


换 的 信息 ,OCF 客户 端 和 服务 器 端 选择 一 个 资源 模型 去 执行 RESTful 交互 或 执行 转化 。 下 面 对 资 源 模 
型 协商 进行 高 层 描 述 。 


8.3.3 资源 模型 指示 


OCF 客户 端 和 服务 器 端 交换 各 自 支持 的 资源 模型 信息 。 基 于 交换 的 信息 ,OCF 客户 端 和 服务 器 端 
选择 一 个 资源 模型 去 执行 RESTful 交互 或 者 执行 转化 ,交换 是 发 现 和 协商 的 一 部 分 。 基 于 交换 ,OCF 
客户 端 和 服务 器 端 遵 循 一 个 过 程 来 保证 它们 之 间 的 互 操作 人 性。 它们 会 选择 一 个 通用 的 资源 模型 或 者 执 
行 资源 模型 之 间 的 转化 。 

资源 模型 模式 交换 : OCF 客户 端 和 服务 器 会 在 初始 化 RESTful 交互 时 共享 资源 模型 信息 。 交 换 
关于 他 们 支持 的 资源 模型 信息 ,作为 会 话 建 立 过 程 的 一 部 分 。 另 外 ,每 个 请 求 或 者 回应 信息 会 携带 正在 
用 哪个 资源 模型 的 指示 。 例 如 ,CoAP 定义 了 “内 容 格 式 选项 ”来 指示 “表示 格式 ”, 如 “application/ 
json”。 可 以 拓展 “内 容 格式 选项 "来 指示 资源 模型 ,如 “application/ipso-json”。 

附属 程序 : 在 OCF 客户 端 和 服务 器 端 交换 资源 模型 信息 之 后 ,执行 合适 的 程序 去 保证 他 们 之 间 的 
互 操作 性 。 最 简单 的 方法 就 是 选择 一 个 OCF 客户 端 和 服务 器 端 都 支持 的 资源 模型 ,OCF 客户 端 和 服 
务 器 端 可 以 通过 第 三 方 交互 。 

除了 资源 密集 型 的 转化 ,基于 一 个 配置 文件 的 方法 可 以 用 于 容纳 多 个 配置 文件 的 OCF 实现 中 ,也 
可 以 用 于 多 个 生态 系统 中 。 

资源 模型 配置 文件 : 框架 定义 资源 模型 配置 文件 ,实施 者 或 用 户 选择 活动 配置 文件 。 所 选择 的 配 
置 文件 将 设备 限制 为 如 何 定义 .实例 化 和 交互 资源 的 规则 。 这 将 允许 与 已 标识 生态 系统 (如 IPSO, 
oneM2M 等 ) 设 备 之 间 的 互 操作 。 尽 管 这 使 得 设备 能 够 参与 并 成 为 任何 给 定 生 态 系 统 的 一 部 分 ,但 是 该 
方案 不 允许 在 运行 时 通用 互 操 作 性 。 尽 管 该 方法 可 能 适合 于 资源 受 限 设备 ,但 是 非 受 限 资源 设备 期 望 
支持 多 个 配置 文件 。 


8.3.4 配置 文件 示例 


IPSO 定义 了 具有 特定 资源 的 智能 对 象 , 并 且 这 些 智能 对 象 获取 该 资源 数据 类 型 确定 的 值 。 智 能 对 
象 规 范 定义 了 这 样 的 对 象 类 别 ,每 个 资源 表示 是 被 建 模 智 能 对 象 的 特性 。 

虽然 术语 可 能 不 同 ,但 在 OCF 中 有 等 同 的 概念 来 表示 这 些 术语 。 本 节 提 供 了 等 效 的 OCF 术语 , 然 
后 以 OCF 术语 描述 IPSO 智能 对 象 。 以 IPSO 对 象 Light Control 作为 参考 示例 。 

IPSO 智能 对 象 的 定义 ,等 同 于 资源 类 型 的 定义 ,也 就 是 定义 了 要 建 模 的 实体 相关 特性 。 具 体 的 
IPSO 资源 相当 于 IPSO 资源 属性 ,具有 定义 的 数据 类 型 .可 接收 值 的 枚 举 、 单 位 ,一般 描 述 和 接 入 模式 
(基于 接口 )。 

IPSO 智能 对 象 定义 .开发 等 资源 类 型 的 一 般 方法 是 忽略 对 象 ID, 并 用 包含 IPSO 对 象 的 OCF*.” 
(点 ) 分 隔 的 名 称 蔡 换 对 象 URN(Uniform Resource Name, 统 一 资源 名 称 )。 或 者 ,对 象 URN 可 以 作为 
资源 类 型 ID 使 用 [只 要 URN 不 包含 任何 “. (点 )] ,使 用 与 资源 类 型 ID 相同 的 对 象 URN 在 与 IPSO 
交互 时 是 兼容 的 。 基 于 对 象 URN 的 命名 对 于 OCF 到 OCF 的 互 操作 性 没有 任何 影响 ,因此 优选 OCF 
格式 ,对 于 OCF 到 OCF 的 互 操作 性 ,只 需要 数据 模型 的 一 致 性 。 

有 两 种 模型 可 用 于 将 IPSO 对 象 转换 为 OCF. 

CD IPSO 智能 对 象 表示 资源 的 地 方 。 在 这 种 情况 下 .IP 智能 对 象 被 视 为 资源 ,其 类 型 与 智能 对 象 
的 描述 匹配 。 此 外 ,IPSO 定义 中 的 每 个 资源 都 表示 为 资源 类 型 中 的 一 个 属性 (IPSO 资源 ID 被 替换 为 
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表示 该 属性 的 字符 串 ) 。 当 在 资源 模型 中 表达 IPSO 数据 模型 时 ,这 是 优选 的 方法 。 

(2) 将 IPSO 智能 对 象 建 模 为 集合 。 将 每 个 IPSO 资源 建 模 为 资源 ,其 具有 与 IPSO 资源 定义 匹配 
的 资源 类 型 。 然 后 ,每 个 资源 实例 都 绑 定 到 表示 此 IPSO 智能 对 象 的 集合 。 

下 面 是 一 个 示例 ,显示 如 何 将 IPSO Light Control 对 象 建 模 为 资源 。 

资源 类 型 为 "Light Control”, 此 对 象 用 于 控制 光源 ,例如 LED 或 其 他 光源 。 它 允许 开关 灯 , 并 且 其 
调 光 器 设置 控制 为 O~ 100% 。 可 选 的 颜色 设置 ,允许 使 用 字符 串 来 指示 所 需 的 颜色 。 表 8-3 和 表 8-4 
分 别 定义 了 资源 类 型 及 其 属性 。 


表 8-3 "Light Control" 资 源 类 型 定义 








资源 类 型 


资源 类 型 ID 


多 实例 


描 x 





Light Control 








oic. light. control 或 者 urn:oma;lwm2m:ext:3311 





带 有 开 / 关 、 可 选调 光 和 能 量 监视 器 的 光 


表 8-4 "Light Control" 资 源 属性 定义 


属性 值 | 属性 值 访问 


是 否 


控制 对 象 























RO ”性 | 属性 名 类 型 规则 单位 模式 强制 d xk 
on/off 控制 : 
开 / 关 on-off 布尔 型 读 写 是 0—off 
1 一 on 
调 光 器 dim DI % es | S oo SERA AE 
颜色 color 字符 串 0100 “| 属性 定义 | KS 5 字符 串 表 示 颜 色 空间 的 一 些 值 
. 测量 单位 定义 ,例如 ,“Cel" 表 示 温 
单位 units Te i "y 度 (摄氏 度 ) 
F 灯 开 着 的 时 间 。 将 值 设 置 为 0 可 以 
计时 ontime 整 型 s 读 写 * 将 计数 器 重 置 
自 上 次 累积 能 量 复位 或 设备 启动 以 
累积 有 功 功率 | cumap 符 点 型 W*h i 否 来 的 累积 有 功 功率 
功率 因数 powfact | 浮 点 型 读 7 负载 的 功率 因数 























第 9 章 


RAML 定义 核心 资源 类 型 





CHAPTER 9 





OCF 规范 中 的 资源 类 型 定义 如 表 9-1 所 示 ,包含 了 所 定义 的 核心 资源 列表 。 















































表 9-1 按 字母 顺序 的 核心 资源 列表 

人 性 化 名 称 资源 类 型 (rt) 注 # 
Collections oic. wk. col 集合 
Device Configuration oic. wk. con 设备 配置 
Platform Configuration oic. wk. con. p 平台 配置 
Device oic. wk. d 设备 
Discoverable Resources Baseline Interface oic. wk. res 可 发 现 资源 基准 接口 
Discoverable Resources Link List Interface oic. wk. res 可 发 现 资源 链表 接口 
Introspection oic. wk. introspection 内 省 
Maintenance oic. wk. mnt 维护 
Resource Directory oic. wk. rd 资源 目录 
Platform. oic. wk. p. 平台 
Ping oic. wk. ping Ping 
Icon oic. r. icon 图 标 
Scenes( Top Level) oic. wk. sceneList 场景 (顶层 ) 
Scenes Collections oic. wk. sceneCollection 场景 集合 
Scenes Member oic. r. switch. binary 场景 成 员 


9.1 OCF 集合 








OCF 集合 资源 类 型 包含 属性 和 链接 .。“oic. if. baseline” 接 口 暴露 了 集合 资源 本 身 的 链接 和 属性 表 
示 。URI 示例 为 */CollectionBaselinelnterfaceURI” ,资源 类 型 (rt) 为 “oic. wk. col”, 


1. RAML 定义 


f * RAML 0.8 
title: Collections 
version: 1.0 
traits: 
- interface- 1l : 
queryParameters: 
if: 
enum: ["oic. if.11"] 
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— interface- b: 
queryParameters: 
if: 
enum: ["oic.if.b"] 
— interface - baseline : 
queryParameters: 
jE: 
enun: ["oic. if. baseline" ] 
— interface- all: 
queryParameters: 
if: 
enum: ["oic. if.11", "oic. if. baseline", "oic. if.b"] 
/CollectionBasel ineInterfaceURI: 
description: | 
OCF Collection Resource Type contains properties and links. 
The oic. if. baseline interface exposes a representation of 
the links and the properties of the collection resource itself 
is : ['interface- baseline'] 


get: 
description: | 
Retrieve on Baseline Interface 
responses : 
200: 
body: 
application/json: 
schema: | 
{ 
" $ schema": "http://json - schema. org/draft - 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights 
reserved.", 


id": "http://www. openconnectivity. org/ocf - apis/core/schemas/oic. collection — 
schema. json#", 
"title": "Collection", 
"definitions": { 
"oic. collection. setoflinks": { 
"description": "A set (array) of simple or individual OIC Links. In addition 
to properties required for an OIC Link, the identifier for that link in this set is also required", 
"type": "array", 
"items": { 
" $ ref": "oic.oic- link- schema. json # /def initions/oic.oic — link" 
) 
Lh 
"oic.collection.alllinks": ( 
"description": "All forms of links in a collection", 
"oneOf" : [ 
t 


" $ ref": "#/definitions/oic. collection. setoflinks" 


Lh 
"oic.collection": ( 
"type": "object", 
"description": "A collection is a set (array) of tagged- link or set (array) 
of simple links along with additional properties to describe the collection itself", 
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"properties": ( 
"id": ( 
"anyof": [ 
{ 
"type": "integer", 
"description": "A number that is unique to that collection; 
like an ordinal number that is not repeated" 
Lh 
t 
"type": "string", 
"description": "A unique string that could be a hash or 
sinilarly unique" 
Lh 
{ 
" $ ref": "oic. types - schema. json# /def initions/uuid", 
"description": "A unique string that could be a UUIDv4" 
} 


l 
"description": "ID for the collection. Can be an value that is unique 
to the use context or a UUIDv4" 
) 
"diti | 
" $ ref": "oic. types - schema. json+ /def initions/uuid", 
"description": "The device ID which is an UUIDv4 string; used for 
backward compatibility with Spec A definition of /oic/res" 
Lh 
"rts? 
" $ ref" :"oic. core — schema. json# /def initions/oic. core/properties/rt", 
"description": "Defines the list of allowable resource types (forTarget 
and anchors) in links included in the collection; new links being created can only be from this list" h 
"drel": { 
"type": "string", 
"description": "When specified this is the default relationship to 
use when an OIC Link does not specify an explicit relationship with * rel* parameter" 





) 
"links": { 

" $ ref": "+ /definitions/oic. collection. alllinks" 
} 


Lh 

"type": "object", 

"allof": [ 
(" $ ref": "oic. core - schema. json# /definitions/oic.core"], 
(" $ ref": " & /definitions/oic.collection") 


"rt": ["oic.wk.col"], 
"id": "unique example id", 
"rts": [ "oic. r. switch. binary", "oic.r.airflow" J, 
"links": [ 

{ 
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"href": 
"rt": ["oic. r. switch. binary" ], 
"if": ["oic. if.a", "oic. if. baseline" ], 
"eps": [ 
{"ep": "coap://[fe80::b1d6]:1111", "pri": 2}, 
{"ep": "coaps://[£e80: :bld6]:1122"}, 
{"ep": "coap + tcp://[2001:db8:a::123]:2222", "pri": 3} 


switch", 








] 
n 
t 
"href": "airFlow", 
"rt": ["oic.r.airflow"], 
"if": ["oic.if.a", "oic. if. baseline"], 
"eps": [ 
(" ep": "coap://[£e80::b1d6]:1111", "pri": 2}, 
("ep" : "coaps://[fe80: :b1d6]:1122"], 
{"ep": "coap + tcp://[2001:db8:a::123]:2222", "pri": 3} 
] 
) 
] 
) 
post: 
description: | 
Update on Baseline Interface 
body: 
application/json: 
schema: | 
{ 
" $ schema": "http: //json— schema. org/draft - 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights 
reserved. ", 
"id": "http://www. openconnectivity. org/ocf - apis/core/schemas/oic. collection - schema. 
json#", 


"title": "Collection", 
"definitions": ( 
"oic.collection. setoflinks": ( 
"description": "A set (array) of simple or individual OIC Links. In addition to 
properties required for an OIC Link, the identifier for that link in this set is also required", 


: "array", 





" $ ref": "oic.oic- link- schema. json # /definitions/oic.oic- link" 


"oic.collection.alllinks": { 
"description": "All forms of links in a collection", 
"oneOf" : [ 
1 


"$ xref": "#/definitions/oic. collection. setoflinks" 


} 
"oic. collection": { 
"type": "object", 
"description": "A collection is a set (array) of tagged- link or set (array) of 
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simple links along with additional properties to describe the collection itself", 
"properties": ( 
"id": { 
"anyof": [ 
t 

"type": "integer", 

"description": "A number that is unique to that collection; like 
an ordinal number that is not repeated" 


}, 
{ 
"type": "string", 
"description": "A unique string that could be a hash or similarly 
unique" 
}, 
{ 
" $ ref": "oic. types - schema. json# /def initions/uuid", 
"description": "A unique string that could be a UUIDv4" 
) 


l 
"description": "ID for the collection. Can be an value that is unique to 


the use context or a UUIDv4" 
L 
"di": ( 
" $ ref": "oic. types - schema. json # /def initions/uuid", 
"description": "The device ID which is an UUIDv4 string; used for backward 
compatibility with Spec A definition of /oic/res" 
} 
"xtg": f 
" $ ref": "oic. core- schema. json # /definitions/oic. core/properties/rt", 
"description": "Defines the list of allowable resource types (for Target 
and anchors) in links included in the collection; new links being created can only be from this list" J; 
"drel": { 
"type": "string", 
"description": "When specified this is the default relationship to use 
when an OIC Link does not specify an explicit relationship with * rel * parameter" 


}, 
"links": ( 

" $ ref": " & /definitions/oic.collection.alllinks" 
) 


}, 

"type": "object", 

"allof":[ 
(" $ ref": "oic. core- schema. json# /def initions/oic.core"), 
(" $ ref": "#/definitions/oic. collection"} 


} 
responses: 
200: 
body: 
application/json: 
schema: | 
{ 
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" $ schema": "http://json- schema. org/draft — 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights 
reserved. ", 
"id": "http://www. openconnectivity. org/ocf — apis/core/schenas/oic. collection — schema. 
json#", 
"title": "Collection", 
"definitions": ( 
"oic. collection. setoflinks": ( 
"description": "A set (array) of simple or individual OIC Links. In addition 
to properties required for an OIC Link, the identifier for that link in this set is also required", 
"type": "array", 
"itens": ( 
" $ ref": "oic.oic- link - schema. json# /def initions/oic.oic - link" 


Lh 
"oic.collection.alllinks": ( 
"description": "All forms of links in a collection", 
"oneOf": [ 
f 


" $ ref": "#/definitions/oic. collection. setoflinks" 


Lh 
"oic.collection": ( 
"type": "object", 
"description": "A collection is a set(array) of tagged- link or set(array) of 
simple links along with additional properties to describe the collection itself", 
"properties": ( 
"udi 
"anyof": [ 
{ 
"type": "integer", 
"description": "A number that is unique to that collection; 
like an ordinal number that is not repeated” 
Lh 


{ 
"type": "string", 
"description": "A unique string that could be a hash or 
similarly unique" 
{ 
" $ ref": "oic. types - schema. json # /definitions/uuid", 
"description": "A unique string that could be a UUIDv4" 
} 


l 
"description": "ID for the collection. Can be a value that is unique 
to the use context or a UUIDv4" 
B 
"di": { 
" $ ref": "oic. types - schena. json# /definitions/uuid", 
"description": "The device ID which is an UUIDv4 string; used for 
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backward compatibility with Spec A definition of /oic/res" 
Lh 
"ts: { 
" $ ref": "oic. core- 
schema. json # /definitions/oic. core/properties/rt", 
"description": "Defines the list of allowable resource types (for Target 
and anchors) in links included in the collection; new links being created can only be from this list" A 
"drel": { 
"type": "string", 
"description": "When specified this is the default relationship to 
use when an OIC Link does not specify an explicit relationship with * rel * parameter" 
Lh 
"links": ( 
" $ ref": "#/definitions/oic. collection. alllinks" 


) 


} 

Lh 

"type": "object", 

"allof":[ 
(" $ ref": "oic. core - schema. json# /def initions/oic.core"], 
(" $ ref": "#/definitions/oic. collection"} 





















































2. 属性 定义 
属性 定义 如 表 9-2 所 示 。 
表 9-2 属性 定义 
属性 名 | 属性 值 类 型 | 是 否 强制 moo 
rt 数组 是 | 资源 类 型 
di FRA 设备 唯一 身份 符号 
E 数组 目标 资源 的 终端 信息 
tide E 链接 关系 的 标题 
priCeps) 整 型 多 个 终端 的 优先 级 
ep(eps) 字符 串 传输 协议 套件 URI 十 定义 终端 位 置信 息 
P WR 规定 从 目标 URI 引用 资源 的 框架 策略 
bm(p) P 是 | 规定 为 了 可 观察 和 可 发 现 的 目标 URI 引用 资源 的 框架 策略 
lis 多 类 型 集合 中 使 用 链接 数组 中 的 Web 实例 标识 符 
目标 URT, 它 可 以 被 指定 为 相对 引用 或 完全 限定 的 UR. 应 该 与 参数 

hret XR 是 | 一 起 使 用 ,使 其 能 够 唯一 
E 多 类 型 内 容 URI 链 接 引用 目标 URI 的 关系 
type 数组 提示 由 目标 URI 引用 的 资源 表示 。 这 表示 用 于 接收 和 发 送 的 媒体 基 开 
ETE EI HUPHDGUME URL bin HELARAN URI 
if 数组 是 | 该 资源 支持 的 接口 





第 9 章 “RAML 定 义 核心 资源 类 型 [Ie 109 


3. CRUDN 行为 
CRUDN 行为 如 表 9-3 所 示 。 
表 9-3 CRUDN 行为 





资 源 创建 检索 更 新 删除 通知 





/CollectionBaselineInterfaceURI get post 




















4. 引用 的 JSON 模式 


oic. oic — link — schema. jason 
{ 
" $ schema": "http://json — schema. org/draft — 04/schema#", 
"description" : "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights reserved.", 
"id": "http://www. openconnectivity. org/ocf - apis/core/schemas/oic.oic- link- schema. json#", 
"definitions": { 
"oic.oic- link": { 
"type": "object", 
"properties": ( 
"href": ( 
"type": "string", 
"naxLength": 256, 
"description": "This is the target URI, it can be specified as a Relative Reference or fully- 
qualified URI. Relative Reference should be used along with the di parameter to make it unique. ", 
"format": 





: "string", 
"naxLength": 64 
Lh 
"minItems": 1, 
"default": ["hosts"] 
) 
{ 


"type": "string", 
"naxLength" : 64 
"default": "hosts" 


] 
"description": "The relation of the target URI referenced by the link to the context URI" 





"ninItens" : 1, 
"description": "Resource Type" 
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: "string", 
: ["oic. if. baseline", "oic. if.11", "oic.if.b", "oic. if.rw", "oic. if. r", 





"oic.if.a", "oic.if.s" ] 
Lh 
"minItems": 1, 
"description": "The interface set supported by this resource” 


L 

"di": { 
"$ ref": "oic. types — schema. json# /definitions/uuid", 
"description": "Unique identifier for device (UUID)" 

} 

"vid 


"description": "Specifies the framework policies on the Resource referenced by the target URI", 
"type": "object", 
"properties": ( 
"bn": ( 
"description": "Specifies the framework policies on the Resource referenced by the target 
URI for e.g. observable and discoverable", 
"type": "integer" 


) 

) 

"required" : ["ba"] 
) 
"title": ( 

"type": "string", 

"naxLength": 64, 

"description": "A title for the link relation. Can be used by the UI to provide a context" 
»h 
"anchor": ( 


"type": "string", 
"maxLength" : 256, 
"description": "This is used to override the context URI e.g. override the URI of the containing 


collection", 
"format": "uri" 
Lh 
"ins": { 
"oneOf": [ 
{ 
"type": "integer", 
"description": "An ordinal number that is not repeated — must be unique in the collection 
context" 
B 
"type": "string", 


"maxLength" : 256, 
"format" : "uri", 
"description": "Any unique string including a URI" 
} 
{ 


" $ ref": "oic. types - schema. json# /definitions/uuid", 
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"description": "Unique identifier (UUID)" 


) 
i, 
"description": "The instance identifier for this web link in an array of web links — used in 
collections" 
Ln 
"type": ( 
"type": "array", 





"description": "A hint at the representation of the resource referenced by the target URI. This 
represents the media types that are used for both accepting and emitting", 
"items" : { 
"type": "string", 
"maxLength": 64 
Lh 
"minItems": 1, 
"default": "application/cbor" 





"eps": { 
"type": "array", 
"description": "the Endpoint information of the target Resource", 
"items": ( 


"type": "object", 
"properties": ( 
"ep": ( 
"type": "string", 
"format": "uri", 
"description": "URI with Transport Protocol Suites + Endpoint Locator as specified" 
) 
"pri": ( 
"type": "integer", 
"minimum": 1, 
"description": "The priority among multiple Endpoints as specified” 
) 


) 
h 
"required": [ "href", "rt", "if" ] 
} 
) 
"type": "object", 
"allof": [ 
( " $ ref": " & /definitions/oic.oic- link" } 


9.2 设备 配置 


允许 为 设备 配置 特定 信息 的 资源 ,URI 示例 为 "/example/DeviceConfigurationResURI” ,资源 类 型 


为 “oic. wk. con", 
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1. RAML 定义 


# % RAML 0.8 
title: OCF Configuration 
version: vl 20160622 
traits: 
- interface- rw : 
queryParameters: 
if: 
enum: ["oic. if. rw"] 
— interface- all : 
queryParameters: 
if: 
enun: ["oic. if. rw", "oic. if.baseline"] 
/example/DeviceConf igurationResURI: 
description: | 
Resource that allows for Device specific information to be configured. 
get: 
description: | 
Retrieves the current Device configuration settings 
is : ['interface- all'] 


responses : 
200: 
body: 
application/json: 
schema: | 
í 

"id": "http://www. openconnectivity. org/ocf - apis/core/schemas/oic. wk. con - schema. 
json#", 

" $ schema" : "http://json— schema. org/draft — 04/schema#", 

"description" : "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights 
reserved.", 


"definitions": ( 
"oic.wk.con": ( 
"type": "object", 
"properties": ( 
"loc": { 

"type": "array", 
"description": "Location information", 
"items": 





"maxLength": 64, 





第 9 章 “RAML 定 义 核心 资源 类 型 [ye 113 


"naxLength": 64, 


"description": "Region" 


"type": "object", 





"language" 
" $ ref": "oic. types - schema. json & /definitions/language - tag", 
"description": "An RFC 5646 language tag. " 


"maxLength" : 64, 
"description": "Device description in the indicated language. " 


Ln 
"ninItems" : 1, 
"description" : "Localized names" 
}, 
"dist 
" $ ref": "oic. types - schema. json & /def init ions/language - tag", 
"description": "Default Language" 


) 
) 
) 
n 
"type": "object", 
"alloe": [ 
{ " $ ref": "oic.core- schema. json# /def initions/oic.core"], 
( " $ ref": " & /definitions/oic.wk.con" } 
l 
"required" : ["n"] 
) 
example: | 
f 


"n": "My Friendly Device Name", 
"rt": ["oic. wk. con"], 

"loc": [32. 777, - 96.797], 
"locn": "My Location Name", 


"e": "USD", 
"r": "MyRegion", 
"ql": "en" 


} 
Post: 
description: | 
Update the information about the Device 
is : [ "interface - rw'] 
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body: 
application/json: 
schema: | 
{ 


"id": "http://www. openconnectivity. org/ocf — apis/core/schemas/oic. wk. con - Update — 


schema. json#", 
" $ schema": "http://json- schema. org/draft - 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights 
reserved. ", 





"type": "object", 
"properties": { 
"loc": ( 
"type": "array", 
"description": "Location information", 
"items": ( 
"type": "number" 

L 
"minItems": 2, 
"maxItens": 2 


"type": "string", 
"naxLength": 64, 
"description": "Human Friendly Name for location" 


"o": { 
"type": "string", 
"maxLength" : 64, 


"description": "Currency" 

»h 

"ud 
"type": "string", 
"maxLength": 64, 
"description": "Region" 





"type": "object", 
"properties": ( 
"language" : ( 
" $ ref": "oic. types — schema. json# /def initions/language — tag", 
"description": "An RFC 5646 language tag." 


"naxLength" : 64, 
"description": "Device description in the indicated language. " 
} 


Lh 
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"minItems" : 1, 
"description": "Localized names" 
} 
"al": { 
" $ ref": "oic. types - schema. json # /definitions/language — tag", 
"description": "Default Language" 
} 
) 
) 
Lh 
"type": "object", 
"allof": [ 
{ "$ ref": "oic.core- schema. rw. json# /definitions/oic. core"}, 
{ " $ ref": "#/definitions/oic. wk. con" } 


"required": ["n"] 


"n": "Nuevo Nombre Anistoso", 
"r": "MyNewRegion", 
"1n": [ ( "language": "es", "value": "Nuevo Nombre Anistoso" } ], 





responses : 
200: 
body: 
application/json: 
schema: | 
t 
"id": "http://www. openconnectivity. org/ocf — apis/core/schemas/oic. wk. con - Update — 
schema. json  ", 
" $ schema": "http://json - schema. org/draft — 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights 
reserved. ", 
"definitions": { 
"oic.wk.con": ( 
"type": "object", 
"properties": ( 
"logs ( 
"type": "array", 
"description": "Location information", 
"items": ( 
"type 

) 
"minItems": 2, 
"maxItems": 2 





"number" 


"maxLength" : 64, 
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"type": "string", 
"maxLength" : 64, 


"description": "Currency" 


"naxLength": 64, 


"properties": { 


" $ ref": "oic. types - schema. json# /definitions/language- tag", 
"description": "An RFC 5646 language tag." 


value": { 
"naxLength": 64, 
"description": "Device description in the indicated language." 
) 
) 
B 
"ninItems" : 1, 
"description": "Localized names" 
Lh 
mal": { 
" $ ref": "oic. types - schema. json # /def init ions/language - tag", 
"description": "Default Language" 
) 
) 
) 
) 
"type": "object", 
"allof":[ 
( " $ ref": "oic. core- schema. rw. json# /def initions/oic.core"], 
( " $ ref": "#/definitions/oic. wk. con" ) 
L 
"required": ["n"] 
} 
example: | 
{ 
"n": "Nuevo Nombre Amistoso", 
"r": "MyNewRegion", 
"In": [ { "language": "es", "value": "Nuevo Nombre Amistoso" } ], 
"dl": "es" 


2. 属性 定义 
属性 定义 如 表 9-4 所 示 。 
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表 9-4 属性 定义 
属性 名 属性 值 类 型 访问 模式 是 否 强制 d 述 
n 字符 串 读 写 是 只 读 , 人 性 化 的 名 称 
di 字符 串 只 读 是 设备 的 唯一 标识 符 (UUID) 
icv 字符 串 只 读 是 OCF 服务 器 的 版 本 
dmv 字符 串 RE 垂直 领域 和 /或 资源 规范 的 版 本 

















3. CRUDN 行为 
CRUDN 行为 如 表 9-5 所 示 。 
表 9-5 CRUDN 行为 
资 dg 创建 检索 更 新 删除 通知 


/ example/DeviceConfigurationResURI get 


























9.3 平台 配置 





允许 平台 配置 指定 信息 的 资源 。URI zi lA " /example/PlatformConfigurationResURI" ,资源 类 
型 定义 为 “oic. wk. con. p". 
1. RAML 定义 


# % RAML 0.8 
title: OCF Platform Configuration 
version: vl — 20160622 
traits: 
- interface- rw : 
queryParameters: 
if: 
enum: ["oic. if. rw"] 
- interface- all : 
queryParameters: 
if: 
enum: ["oic. if. rw", "oic. if. baseline" ] 
/exanple/PlatformConfigurationResURI: 
description: | 
Resource that allows for platform specific information to be configured. 
get: 
description: | 
Retrieves the current platform configuration settings 
is : ['interface- all'] 
responses : 
200: 
body: 
application/json: 
schema: | 
t 


"id" 


: "http://www. openconnect ivity. org/ocf — apis/core/schemas/oic. wk. con. p- schema 
.json£", 
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" $ schema": "http://json— schema. org/draft - 04/schena#", 
"description" : "Copyright (c) 2017 Open Connectivity Foundation, Inc. All rights reserved. ", 
"definitions": { 
"oic.wk.con.p": { 
"type": "object", 


"properties": ( 
"npn": ( 
Skype" s "array"; 
"items" : 
t 


"type": "object", 
"properties": ( 
"language" : ( 
" $ ref": "oic. types - schema. json # /def initions/language- tag", 
"description": "An RFC 5646 language tag. " 





"maxLength": 64, 
"description": "Platform description in the indicated language." 
) 
) 
Lh 
"minItems" : 1, 
"description": "Platform names" 
) 
) 
) 
Lh 
"type": "object", 
"allof": [ 
( " $ ref": "oic. core- schema. json# /def initions/oic.core"], 
( " $ ref": "#/definitions/oic. wk. con. p" } 
] 
} 
example: | 
t 
"rt": ["oic.wk. con. p"), 
"mnpn": [ { "language": "en", "value": "My Friendly Device Name" ) ] 
) 
post: 
description: | 
Update the information about the platform 
is : ['interface- rw'] 
body: 
application/json: 
schema: | 
{ 


"id": "http://www. openconnectivity. org/ocf — apis/core/schemas/oic. wk. con. p — Update — 
schema. json#", 

" $ schema": "http://json— schema. org/draft — 04/schema#", 

"description" : "Copyright (c) 2017 Open Connectivity Foundation, Inc. All rights 


reserved.", 





"definitions" 
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"oic.wk.con.p": { 
"type": "object", 
"properties": ( 








"language' 

" $ ref": "oic. types - schema. json# /def initions/language - tag", 

"description": "An RFC 5646 language tag." 
b 
"value": { 

"type": "string", 

"naxLength" : 64, 

"description": "Platform description in the indicated language." 

) 
) 
Lh 
"ninItens" : 1, 
"description": "Platform names" 
) 
) 

) 
}, 
"type": "object", 
"allof":[ 

( " $ ref": "oic.core- schema. rw. json# /def initions/oic.core"], 

( " $ ref": " & /definitions/oic.wk.con.p" } 


required": ["mnpn"] 


"n": "Nuevo nombre", 
"mnpn": [ { "language": 





es", "value": "Nuevo nombre de Plataforma Amigable" } ] 
) 
responses : 
200: 
body: 
application/json: 
schema: | 





: "http://www. openconnectivity. org/ocf — apis/core/schemas/oic. wk. con. p - Update 一 
schema. json£ ", 
" $ schema": "http: //json- schema. org/draft - 04/schema#", 
"description" : "Copyright (c) 2017 Open Connectivity Foundation, Inc. All rights reserved.", 
"definitions" 
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{ 
"type": "object", 
"properties": ( 
“Language”: { 
" $ ref": "oic. types — schema. json # /def initions/language - tag", 
"description": "An RFC 5646 language tag. " 
b 
"value": { 
"type": "string", 
"maxLength" : 64, 
"description": "Platform description in the indicated language." 
} 
} 
b 
"minItems" : 1, 
"description": "Platform names" 
} 
} 
} 
B 
"type": "object", 
"allof": [ 
( " $ ref": "oic. core- schema. rw. json # /def initions/oic.core"), 
( " $ ref": " & /definitions/oic. wk. con. p" } 


required": ["mnpn"] 


"n": "Nuevo nombre", 


mnpn": [ ( "language": "es", "value": "Nuevo nombre de Plataforma Amigable" ) ] 
) 


























2. 属性 定义 
属性 定义 如 表 9-6 Bros 。 
表 9-6 属性 定义 
属 性 名 属性 值 类 型 访问 模式 是 否 强 制 描 3k 
mnpn 数组 平台 名 称 
value 字符 串 指定 语言 下 的 平台 描述 
language 多 类 型 RFC 5646 语言 标签 
3. CRUDN 行为 


CRUDN 行为 如 表 9-7 Bios 


表 9-7 CRUDN 行为 





资 源 创建 检索 更 新 删除 通知 





/ example/PlatformConfigurationResURI get post 
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9.4 设备 


每 个 服务 器 端 托 管 的 已 知 资源 允许 发 现 逻 辑 设备 特定 信息 。URI 示例 为 /oic/d”, 资 源 类 型 定义 
为 “oic. wk. d", 
1. RAML 定义 


# * RAML 0.8 
title: OIC Root Device 
version: vl - 20160622 
traits: 
— interface : 
queryParameters: 
if: 
enum: ["oic. if.r", "oic. if. baseline" ] 
/oic/d: 
description: | 
Known resource that is hosted by every Server. Allows for logical device specific information to be 

discovered. 
['interface'] 





is 
get: 
description: | 
Retrieve the information about the Device 
responses : 
200: 
body: 
application/json: 
schema: | 
{ 
" $ schema": "http://json— schemas. org/draft - 04/schema#", 
"description" : "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights 
reserved.", 
"id": "http://www. openconnectivity. org/ocf — apis/core/schemas/oic.wk.d - schema. json#", 
"definitions": { 
"oic.wk.d": { 
"type": "object", 
"properties": { 
"di": { 
" $ ref": "oic. types — schema. json# /definitions/uuid", 
"readonly": true, 
"description": "Unique identifier for device (UUID)" 
) 
"iow": q 
"type": "string", 
"maxLength" : 64, 
"readOnly": true, 
"description": "The version of the OIC Server" 


"type": "string", 
"maxLength": 256, 
"readonly": true, 
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"description": "Spec versions of the Resource and Device Specifications to which 
this device data model is implemented" 


"type": "object", 
"properties": ( 
"language" : 
" $ ref": "oic. types — schema. json# /def initions/language - tag", 
"readOnly": true, 
"description": "An RFC 5646 language tag." 








"readOnly": true, 
"description": "Device description in the indicated language." 


} 
} 
Lh 
"ninItens" : 1, 
readOnly" : true, 
"description": "Localized Description." 
) 





"type": "string", 
"naxLength": 64, 

"readOnly": true, 

"description": "Software version." 


"type": "object", 
"properties": ( 





oic.types - schema. json # /def initions/language - tag", 
"readOnly": true, 
"description": "An RFC 5646 language tag." 





"readonly": true, 
"description": "Manufacturer Name." 
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"dnno": ( 
"type": "string", 
"maxLength": 64, 
"readOnly": true, 
"description": "Model number as designated by manufacturer." 
Lh 
"piid": { 
" $ ref": "oic. types - schema. json # /def initions/uuid", 
"readOnly" : true, 
"description": "Protocol independent unique identifier for device (UUID) that is 






































immutable." 
) 
) 
} 
b 
"type": "object", 
"allof": [ 
( " $ ref": "oic. core — schema. json# /definitions/oic. core"}, 
{ " $ ref": "+#/definitions/oic. wk.d" } 
1, 
"required": [ "n", "di", "icv", "dmv", "piid" ] 
) 
example: | 
{ 
"nite "Device 1", 
"rt":  ["oic.wk.d"], 
"di": "54919CA5 - 4101 — 4AE4 — 595B - 353C51AA983C", 
"icv": "ocf.1.0.0", 
"dmv": "ocf.res.1.0.0, ocf.sh.1.0.0", 
"piid": "6FOAACO4 — 2BB0 — 468D — B57C - 16570A26AE48" 
) 
2. 属性 定义 
属性 定义 如 表 9-8 所 示 o 
表 9-8 属性 定义 
属 性 名 属性 值 类 型 访问 模式 是 否 强制 描 述 
id 数组 只 读 本 地 描述 
value(id) Tm 只 读 用 指定 语言 进行 设备 描述 
language 多 类 型 Ri RFC 5646 语言 标签 
piid 多 类 型 只 读 是 不 可 变 的 、 独 立 于 协议 的 设备 唯一 标识 符 (UUID) 
di 多 类 型 RE 是 设备 唯一 标识 符 (UUID) 
dmno Tm 只 读 由 制造 商 设计 的 型 号 
sv Tm RE 软件 版 本 
dmn 数组 只 读 制造 商 名 称 
value(dmn) 字符 串 只 读 制定 语言 下 的 制造 商 名 称 
language( dmn) 多 类 型 只 读 RFC 5646 语言 标签 
icv 字符 串 只 读 是 OCF 服务 器 的 版 本 
dmv 字符 串 只 读 是 该 设备 数据 模型 实现 的 资源 和 设备 规格 的 版 本 
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3. CRUDN 行为 
CRUDN 行为 如 表 9-9 所 示 。 


表 9-9 CRUDN 行为 
资 dg 创建 检索 更 新 删除 通知 


/oic/d get 


























9.5 维护 


设备 维护 所 用 的 资源 ,可 用 于 诊断 目的 。 出 厂 重 置 参数 “fr” 是 一 个 布尔 值 , 值 0 表示 无 操作 (默认 
值 ); 值 1 表示 在 出 厂 后 复位 。 开 始 出 厂 复位 后 ,此 值 应 更 改 回 默认 值 *rb”( 重 新 启动 ), 它 也 是 一 个 布 
尔 值 , 值 0 表示 无 操作 (默认 值 ), 值 1 表示 开始 重新 启动 ,之 后 此 值 应 更 改 回 默认 值 。URI 示例 为 
“/oic/mnt”, 资 源 类 型 定义 为 ~oic. wk. mnt”, 

1. RAML 定义 


# % RAML 0.8 
title: Maintenance 
version: vl — 20160622 
traits: 
- interface- rw : 
queryParameters: 
if: 
enum: ["oic. if. rw", "oic. if. baseline" ] 
- interface- all : 
queryParameters: 
if; 
enum: ["oic. if.rw", "oic. if.r", "oic. if. baseline" ] 
/oic/mnt: 
description: | 
The resource through which a Device is maintained and can be used for diagnostic purposes. 
fr (Factory Reset) is a boolean. 
The value 0 means No action (Default), the value 1 means Start Factory Reset 
After factory reset, this value shall be changed back to the default value 
rb (Reboot) is a boolean. 
The value 0 means No action (Default), the value 1 means Start Reboot 
After Reboot, this value shall be changed back to the default value 


is : ['interface- all'] 
description: | 
Retrieve the maintenance action status 
responses : 
200: 
body: 
application/json: 
schema: | 
{ 
" $ schema": "http: //json— schemas. org/draft — 04/schema#", 
"description" : "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights 
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reserved.", 
"id": "http://www. openconnectivity. org/ocf - apis/core/schemas/oic. wk. mnt — 
schema. json#", 
"definitions": { 
"oic. wk. mnt": { 
"type": "object", 
"anyOf": [ 
(" required" : ["fr"]}, 
("required": ["rb"]} 


L 
"properties": { 
"£*:( 
"type": "boolean", 
"description": "Factory Reset" 
}, 
"rb": { 
"type": "boolean", 
"description": "Reboot Action" 
) 
) 
) 
) 
"type": "object", 
"allof":[ 


( " $ ref": "oic.core - schema. json# /def initions/oic. core"], 
( " $ ref": "#/definitions/oic. wk. mnt" } 


] 
i 
example: | 
1 
"rt": ["oic. wk. mnt"), 
"fr": false, 
"rb": false 
} 
post: 
is : ['interface- rw'] 
description: | 
Set the maintenance action(s) 
body: 
application/json: 
schema: | 


{ 
" $ schema": "http://json - schemas. org/draft - 04/schema#", 


"description" : "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights reserved.", 
"id": "http://www. openconnectivity. org/ocf — apis/core/schemas/oic. wk. mnt — schema. json#", 
"definitions": { 
"oic.wk.mnt": { 
"type": "object", 
"anyof": [ 
("required" : ["fr"]}, 
("required": ["rb"]} 
L 
"properties": { 
"pet 
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"type": "boolean", 
"description": "Factory Reset" 
L 
"a 
"type": "boolean", 
"description": "Reboot Action" 
} 
} 
} 
}, 
"type": "object", 
"allof": [ 
{ " $ ref": "oic. core- schema. json # /definitions/oic. core"}, 
{ "$ ref": "#/definitions/oic. wk. mnt" } 
] 
} 
example: | 
{ 
"fr": false, 
"rb": false 


) 


responses : 
200: 


reserved. 


body: 
application/json: 
schema: | 
{ 

" $ schema": "http://json - schemas. org/draft - 04/schema & ", 

"description" : "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights 
" 
, 


id": "http://www. openconnectivity. org/ocf — apis/core/schemas/oic. wk. mnt — 


Schema. json & ", 


"definitions": 
"oic.wk.mnt": ( 
"type": "object", 
"anyof": [ 
(" required" : ["fr"]}, 
(" required": ["rb"]) 
l 
"properties": { 
"£x" ef 
"type": "boolean", 
"description": "Factory Reset" 
) 
"zb": { 
"type": "boolean", 
"description": "Reboot Action" 
} 





}, 
: "object", 
"allof": [ 
{ " $ ref": "oic. core — schema. json# /definitions/oic. core"}, 
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{ "$ ref": "#/definitions/oic. wk. mnt" } 
] 
} 











example: | 
{ 
"fr": false, 
"rb": false 
} 
2. 属性 定义 
属性 定义 如 表 9-10 所 示 。 
表 9-10 属性 定义 
属 性 名 属性 值 类 型 访问 模式 是 否 强 制 描 述 
fr 布尔 型 只 读 是 工厂 重 置 
rb 布尔 型 只 读 重新 启动 操作 














3. CRUDN 行为 
CRUDN 行为 如 表 9-11 所 示 。 


表 9-11 CRUDN 行为 
资源 创建 检索 更 新 删除 通知 


/oic/mnt get post 





9.6 平台 


已 知 资源 定义 托管 服务 器 端的 平台 ,允许 发 现 特定 于 平台 的 信息 。URI 示例 为 */oic/p”, 资 源 类 型 
定义 为 *oic. wk. p", 
1. RAML 定义 


# * RAML 0.8 
title: Platform 
version: vl ~ 20160622 
traits: 
- interface : 
queryParameters: 
if: 
enum: ["oic. if.r", "oic. if. baseline"] 
/oic/p: 
description: | 
Known resource that is defines the platform on which an Server is hosted. 
Allows for platform specific information to be discovered. 
is : ['interface'] 
get: 
description: | 
Retrieves the information about the Platform 
responses : 
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200: 
body: 
application/json: 
schema: | 
t 
" $ schema": "http://json - schema. org/draft — 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved.", 
"id": "http://openconnectivityfoundation. org/core/schemas/oic. wk. p - schema. json#", 
"definitions": ( 
"oic.wk.p": { 
"type": "object", 
"properties": ( 
"di": { 
"type": "string", 
"pattern": "[a- fA- F0 - 9](8) - [a- £a- F0 - 9](4) - [a- fA-FO-9]{4} - [a- 
£A-F0-9](4)- [a-fA- FO -9](12) $", 
"description": "ReadOnly, Platform Identifier as a UUID" 





"type" : "string", 
"description": "ReadOnly, Manufacturer Nane", 
"naxLength": 64 





"type": "string", 
"description": "ReadOnly, Manufacturer's URL", 
"maxLength": 256, 


"format": "uri" 











mnmo" : 
"type": 
"maxLength": 64, 
"description": " Model number as designated by manufacturer" 
) 
"nndt" : 
"type": "string", 
"description": "ReadOnly, Manufacturing Date", 
"format": "date" 
}, 
"nnpy" : 
"type": "string", 
"maxLength": 6 
"description": "ReadOnly, Platform Version" 
h 
"nnos 





"type": "string", 
"maxLength” : 64, 
"description": "Readonly, Platform Resident OS Version" 





"mnhw" : 
"type": "string", 
"maxLength" : 64, 
"description": "Readonly, Platform Hardware Version" 
Lh 
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mnfv": { 
"type": "string", 
"naxLength" : 64, 
"description": "ReadOnly, Manufacturer's firmware version" 


mns": ( 
"type": "string", 
"description": "ReadOnly, Manufacturer's Support Information URL", 
"naxLength": 256, 


"format": "uri" 


Sper 
"type": "string", 
"description": "ReadOnly, Reference time for the device", 
"format": "date - time" 
) 
"vid": ( 
"type": "string", 
"naxLength": 64, 
"description": "ReadOnly, Manufacturer's defined string for the platform. The 
string is freeform and up to the manufacturer on what text to populate it" 
) 


) 
) 
Lh 
"type": "object", 
"alloe": [ 


{ "$ ref": "oic.core- schema. json # /def initions/oic.core"], 
{" $ ref": " & /definitions/oic.wk.p" } 
l 
"required": [ "pi", "mnmn"] 
) 
example: | 
{ 
"pi": "54919CA5 — 4101 — 4AEA — 595B — 353C51AA983C", 
"xt": ["oic.wk.p"], 
"mnmn" : "Acme, Inc" 


























} 
2. 属性 定义 
属性 定义 如 表 9-12 BAS. 
表 9-12 属性 定义 
属 性 名 属性 值 类 型 访问 模式 是 否 强制 fi xk 
pi 字符 串 Ri L3 平台 标识 符 作为 UUID 
mnmn 字符 串 只 读 是 名 称 
mnml 字符 串 只 读 URL 
mnmo 字符 串 只 读 由 制造 商 指定 的 型 号 
mndt 字符 串 只 读 制造 日 期 
mnpv 字符 串 只 读 平台 版 本 
mnos 字符 串 只 读 只 读 ,平台 驻 留 操作 系统 版 本 
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续 表 
局 性 名 | REM | 访问 模式 | 是否 强制 m 述 
Wd FAR RE ARAE 
iam 字符 惠 Ri 制造 商 的 因 件 版 本 
Em 字符 惠 只 读 制造 商 的 支持 信息 URL 
* 字符 惠 只 读 设备 的 参考 时 间 
制造 商 为 平台 定义 的 字符 囊 。 字 符 审 是 自 南 
ids TN Ae 格式 的 ,并 且 根据 制造 商 填充 文本 
3. CRUDN 行为 


CRUDN 行为 如 表 9-13 所 示 。 
表 9-13 CRUDN 行为 
资 源 | 创建 | ex | 更 新 | 删除 EET. 


/oic/p get 








9.7 ping 


此 资源 用 于 客户 端 保持 其 与 服务 器 端 连接 处 于 活动 状态 。URI 示例 为 “/oic/ping”, 资 源 类 型 定义 
为 “oic, wk. ping”. 
1. RAML 定义 


f % RAML 0.8 
title: Ping 
version: vl — 20160622 
traits: 
- interface : 
queryParameters: 
if: 
enum: ["oic. if. rw", "oic. if. baseline" ] 
/oic/ping: 
description: | 
The resource using which a Client keeps its Connection with a Server active. 
is : ['interface'] 
get: 
description: | 
Retrieve the ping information 
responses : 
200: 
body: 
application/json: 
schema: | 
{ 
" $ schema": "http://json- schema. org/draft — 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved.", 
"id": "http: //openconnect ivityfoundat ion. org/core/schemas/oic. wk. ping — schema. json#", 
"definitions": { 
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"oic. wk. ping": { 
"type": "object", 
"properties": ( 
"in": { 
"type": "integer", 
"description": "ReadWrite, Indicates the interval for which connection shall be 


kept alive") 


i 
} 
Lh 
"type": "object", 
"alor": [ 


{ " $ xref": "oic. core- schema. json# /definitions/oic.core"], 
{ "$ ref": " & /definitions/oic.wk.ping" } 
1, 
"required": [ "in"] 
) 
example: | 
{ 
"rt": ["oic. wk. ping"], 
"n": "Ping Information", 
"in": 16 


) 





2. 属性 定义 
属性 定义 如 表 9-14 所 示 。 
表 9-14 属性 定义 
属 性 名 属性 值 类 型 访问 模式 是 否 强制 d x 
in 整 型 读 写 读 写 ,指示 连接 应 保持 活动 的 时 间 间 隔 


3. CRUDN 行为 
CRUDN 行为 如 表 9-15 所 示 。 
表 9-15 CRUDN 行为 
资 源 创建 检索 更 新 删除 通知 


/oic/ ping get | | 

















9.8 可 发 现 资 源 基 准 接口 


可 发 现 资 源 基准 接口 为 */oic/res”, 的 基准 表示 ,可 发 现 资源 的 列表 。URI 示例 为 “/oic/res”, 资 源 
类 型 定义 为 *oic. wk. res", 

1. RAML 定义 

f * RAML 0.8 

title: Discoverable Resources 


version: vi — 20160622 
traits: 














132 去 | OCF 技 术 原理 及 物 联网 程序 开发 指南 


- interface- ll : 
queryParameters: 
if: 
enum: ["oic. if.11"] 
— interface- baseline : 
queryParameters: 
if: 
enun: ["oic. if.baseline"] 
/oic - res - BaselineInterfaceURI: 
description: | 
Baseline representation of /oic/res; list of discoverable resources 
is : [interface - baseline'] 


get: 
description: | 

Retrieve the discoverable resource set, baseline interface 

responses : 

200: 

body: 
application/json: 
schema: | 
{ 
" $ schema": "http: //json - schema. org/draft - v4/schema#", 
"description" : "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights 
reserved.", 


id": "http://www. openconnectivity. org/ocf — apis/core/schemas/oic. wk. res — 
schema. json#", 
"definitions": { 

"oic. res — baseline": { 
"type": "object", 
"properties": ( 

ba oe | 
"type": "array", 
"items" : { 
"type" : "string", 
"naxLength": 64 





inItems" : 1, 
"readOnly": true, 
"description": "Resource Type" 





: "string", 
enum" : ["oic. if. baseline", "oic.if.11"] 


Lh 
"ninItens": 1, 
"readOnly": true, 
"description": "The interface set supported by this resource" 


": "string", 
"naxLength": 64, 
"readonly": true, 
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"description": "Human friendly name" 
h 
"mpro": { 

"readonly": true, 


"description": "Supported messaging protocols", 
"type": "string", 
"maxLength" : 64 





" $ ref": "oic.oic- link - schema. json# /definitions/oic. oic — link" 
} 
) 
) 
"required": ["rt", "if", "links"] 
) 

Lh 
"description": "The list of resources expressed as OIC links", 
"type": "array", 





"items": ( 
" $ ref": " & /definitions/oic.res - baseline" 
} 
} 
example: | 
[ 
{ 
"rt": ["oic. wk. res"], 
"if": ["oic. if. baseline", "oic. if. 11" J, 
"links": 
i 
t 
"href": "/hunidity", 
"rt": ["oic. r. hunidity"], 
"i£": ["oie. i£.2"], 
"p": {"bm": 3), 
"coaps: //[fe80: :b1d6] :1111", "pri": 2}, 
"coaps: //[£e80: :b1d6] :1122"), 
: "coap + tcp://[2001:db8:a::123]:2222", "pri": 3} 
"href": "/temperature", 
"rt": ["oic. r. temperature" ], 
"if": ["oic.if.s"], 
"p": ("bn": 3}, 
"eps": [ 
("ep" : "coaps: //[[2001:db8:a::123]:2222") 
] 
} 
] 
) 
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2. 属性 定义 
属性 定义 如 表 9-16 所 示 。 
表 9-16 属性 定义 
mou 名 | 属性 值 类 型 访问 模式 是 否 强制 iB 
n FER R 人 性 化 名 称 
n 数组 nik 资源 类型 
mpro TU mi 支持 的 消息 协议 
links 数组 是 链接 
i 数组 mik 是 该 资源 支持 的 接口 集 
3. CRUDN 行为 
CRUDN 行为 如 表 9-17 所 示 。 
表 9-17 CRUDN 行为 
资源 | a | ea | 更 新 | mk | 通知 





/oic/res get 


9.9 可 发 现 资 源 的 链接 表 接口 


可 发 现 资源 的 链接 表 接口 是 /oic/res” 的 链接 表示 ,可 发 现 资源 的 列表 。URI 示例 为 */oic/res”, 资 
源 类 型 定义 为 “oic. wk. res”. 
1. RAML 定义 


# % RAML 0.8 
title: Discoverable Resources 
version: v1 — 20160622 
traits: 
- interface- ll : 
queryParameters: 
if: 
enum: ["oic. if. 11"] 
- interface- baseline : 
queryParameters: 
if: 
enun: ["oic. if. baseline" ] 
/oic- res- llInterfaceURI: 
description: | 
Link list representation of /oic/res; list of discoverable resources 
is : ['interface- 11'] 
get: 
description: | 
Retrieve the discoverable resource set, link list interface 
responses : 
200: 
body: 
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application/json: 
schema: | 
{ 
" $ schema": "http://json— schema. org/draft - v4/schema#", 
"description" : "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights 
reserved.", 
"id": "http://www. openconnectivity. org/ocf — apis/core/schemas/oic. wk. res — schema — 
1l. json#", 
"description": "The list of resources expressed as OCF links without di", 
"definitions": { 
"oic. res- 11": { 
" $ ref": "oic.oic- link — schema. json# /definitions/oic. oic — link" 
} 
) 
"type": "array", 
"items": { 
"$ ref": " & /definitions/oic.res- ll" 
} 
} 
example: | 
{ 
"href": "/hunidity", 
"rt": ["oic. r. humidity" ], 
"Ig": "oic; 4E. 8"], 
"p": {"bm": 3), 
"eps": [ 
{"ep": "coaps: //[ £e80: :b1d6] :1111", "pri": 2}, 
{"ep": "coaps://[fe80: :b1d6] :1122"], 
{"ep": "coaps + tcp://[2001:db8:a::123]:2222", "pri": 3) 









"href": "/temperature", 
"rt": ["oic.r.temperature"], 


:123]:2222"} 





2. 属性 定义 
属性 定义 如 表 9-18 BAS. 
表 9-18 属性 定义 





属 性 名 | 属性 值 类 型 是 否 强制 描 æ 





rt 数组 是 资源 类 型 





di 多 类 型 设备 唯一 标识 符 (UUID) 





title FAR 链接 关系 标题 ,可 为 界面 提供 内 容 














eps 数组 目标 资源 的 终端 信息 
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续 表 
属 性 名 | 属性 值 类 型 是 否 强制 d æ 
priCeps) 整 型 多 终端 的 优先 级 
ep(eps) 字符 串 传输 协议 套件 URI 十 终端 位 置信 息 
p xs 规定 从 目标 URI 引用 资源 的 框架 策略 
bm(p) 整 型 是 规定 为 了 可 观察 和 可 发 现 目标 URI 引 用 资源 的 框架 策略 
ins 多 类 型 集合 中 使 用 链接 数组 中 的 Web 实例 标识 符 
目标 URI, 它 可 以 被 指定 为 相对 引用 或 完全 限定 的 URI。 应 该 与 di 
eet =m = 参数 一 起 使 用 使 其 能 够 唯一 
rel 多 类 型 内 容 URI 链 接 引用 目标 URI 的 关系 
提示 由 目标 URI 引用 的 资源 表示 。 这 表示 用 于 接收 和 发 送 的 媒体 
type 数组 类 型 
anchor 字符 串 用 于 覆盖 内 容 URI, 例 如 ,覆盖 包含 集合 的 URI 
if 数组 是 该 资源 支持 的 接口 
3. CRUDN 行为 


CRUDN 行为 如 表 9-19 所 示 。 


表 9-19 CRUDN 行为 





资源 创建 检索 更 新 删除 通知 
/oic/res get 
4. 引用 JSON 方案 


oic.oic- link - schema. json 
{ 
" $ schema" : "http://json— schema. org/draft - 04/schema#", 
"description" : "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights reserved. ", 
"id": "http://www. openconnectivity. org/ocf - apis/core/schemas/oic.oic- link- schema. json#", 
"definitions": { 
"oic.oic- link": ( 
"type": "object", 
"properties": ( 
"href": ( 
"type": "string", 
"maxLength": 2 
"description": "This is the target URI, it can be specified as a Relative Reference orfully- 
qualified URI. Relative Reference should be used along with the di parameter to make it unique.", 
"format": "uri" 
) 
“zal”: ( 
"oneOf" :[ 
{ 
"type": "array", 
"items": { 
"type": "string", 
"maxLength": 64 
Lh 
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"ninItens": 1, 
"default": ["hosts"] 
L 
{ 


"type": "string", 

"naxLength" : 64, 

"default": "hosts" 
) 


1, 
"description": "The relation of the target URI referenced by the link to the context URI" 





"string", 
"enum" : ["oic. if. baseline", "oic.if.ll", "oic.if.b", "oic. if.rw", "oic. if.r", 
"oic.if.a", "oic.if.s" ] 
} 
"minItems": 1, 
"description": "The interface set supported by this resource" 
) 
"ai" 4 
" $ ref": "oic. types — schema. json# /def initions/uuid", 
"description": "Unique identifier for device (UUID)" 
} 
"pl 
"description": "Specifies the framework policies on the Resource referenced by the target URI", 
"type": "object", 
"properties": ( 
"bn": ( 
"description": "Specifies the framework policies on the Resource referenced by the target 
URI for e.g. observable and discoverable", 
"type": "integer" 


"required" : ["bm"] 





anchor": ( 
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"This is used to override the context URI e.g. override the URI of the containing 





"type": "integer", 
"description": "An ordinal number that is not repeated — must be unique in the collection 


context" 
}, 
{ 
"type": "string", 
"naxLength" : 256, 
"format" : "uri", 
"description": "Any unique string including a URI" 
}, 
{ 
" $ ref": "oic. types - schema. json# /definitions/uuid", 
"description": "Unique identifier (UUID)" 
) 
L 
"description": "The instance identifier for this web link in an array of web links - used in 
collections" 





: "array", 
"description": "A hint at the representation of the resource referenced by the target URI. This 
represents the media types that are used for both accepting and emitting", 


items" : ( 
moe 


"minItems": 1, 
"default": "application/cbor" 
Lh 
"eps": ( 
"type": "array", 
"description": "the Endpoint information of the target Resource", 
"items": ( 
"type": "object", 
"properties": ( 
"ep": ( 
"type": "string", 
"format": "uri", 
"description": "URI with Transport Protocol Suites * Endpoint Locator as specified" 
Lh 





"description": "The priority among multiple Endpoints as specified" 
} 
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} 
hn 
"required": [ "href", "rt", "if" ] 
} 
B 
"type": "object", 
"allof":[ 
( " $ ref": " & /definitions/oic.oic- link" } 
] 





9.10 场景 (顶层 ) 


顶层 场景 资源 是 通用 集合 资源 , “rts” 值 应 包含 “oic. sceneCollection ”资源 类 型 。URI 示例 为 
“/SceneListResURI” ,资源 类 型 定义 为 “oic. wk. sceneList”。 
1. RAML 定义 


# % RAML 0.8 
title: Scene 
version: vl — 20160622 
traits: 
- interface : 
queryParameters: 
if: 
enum: ["oic. if.a", "oic. if.ll", "oic. if.baseline"] 
/SceneListResURI: 
description: | 
Toplevel Scene resource. This resource is a generic collection resource. The rts value shall contain oic. 
sceneCollection resource types. 
get: 
description: | 
Provides the current list of web links pointing to scenes 
responses : 
200: 
body: 
application/json: 
schema: | 
t 
" $ schema": "http: //json - schema. org/draft - 04/schema # ", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved. ", 
"id": "http: //openconnectivityfoundation. org/core/schemas/oic. collection - schema. json#", 
"title": "Collection", 
"definitions": ( 
" oic. collection. setoflinks": { 
"type": "object", 
"description": "A set (array) of simple or individual OIC Links", 
"properties": { 
"links": ( 
"type": "array", 
"description": "Array of OIC Links. In addition to properties required for an OIC 
Link, the identifier for that link in this set is also required", 
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" $ ref": "oic.oic- link- schema. json # " 


) 
l 
"required": ["ins"] 
} 
} 


} 
Lh 
"oic. collection. tagged- setoflinks": { 
"type": "object", 
"description": "A tagged link is a set (array) of links that are tagged with one or nore 
key - value pairs usually either an ID or Name or both", 





"allof": [ 
{ 
" $ ref":" # /definitions/oic. collection. setoflinks" 
B 
t 
"properties": ( 
"a": { 
"type": "string", 
"description": "Used to name i.e. tag the set of links", 
"format": "UTF8" 
}, 
"ae 
"oneOf" : [ 
{ 


"type": "integer", 
"description": "A number that is unique to that collection; like an 
ordinal number that is not repeated” 

}, 
{ 

"type": "string", 

"description": "A unique string that could be a hash or similarly unique" 
Lh 
t 


"type": "string", 
"format": "UUID", 
"description": "A unique string that could be a UUIDv4" 
} 
L 
"description": "Id for each set of links i.e. tag. Can be an value that is 
unique to the use context or a UUIDv4" 


"type": "string", 

"description": "The device ID which is an UUIDv string; used for backward 
compatibility with Spec A defintion of /oic/res", 

"format": "UUID" 
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l 
"required": [ "links" ] 
) 
"oic. collection. setof — tagged — setoflinks": { 
"type": "array", 
"items": ( 
" $ ref": " & /definitions/oic. collection. tagged- setoflinks" 
) 
h 
"oic. collection. alllinks": { 
"description": "All forms of links in a collection", 
"oneOf": [ 
{ 
" $ ref": "# /definitions/oic. collection. setof - tagged - setof links" 
) 
t 


" $ ref" :" # /definitions/oic. collection. setoflinks" 


required": [ "links" ] 


"oic.collection": { 
"type": "object", 
"description": "A collection is a set (array) of tagged - link or set (array) of 
simple links along with additional properties to describe the collection itself", 
"allof": [ 
{ 
" $ ref" :" # /definitions/oic. collection. alllinks" 
Lh 
{ 
"properties": { 
"n": { 
"type": "string", 
"description": "User friendly name of the collection", 
"format": "UTE" 


"type": "integer", 
"description": "A number that is unique to that collection; like an 
ordinal number that is not repeated" 
}, 
{ 
"type": "string", 
"description": "A unique string that could be a hash or similarly unique" 
Lh 
t 
"type": "string", 
"format": "UUID", "description": "A unique string that could be a UUIDv4" 
H 
L 
"description": "ID for the collection. Can be an value that is unique to the 
use context or a UUIDv4" 
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"type": "string", 

"description": "Defines the list of allowable resource types (for Target and 
anchors) in links included in the collection; new links being created can only be from this list", 

"format": "UTF8" 


"type": "string", 
“description”: "When specified this is the default relationship to use when an 
OIC Link does not specify an explicit relationship with * rel* parameter" 


) 
} 
} 
] 
) 
B 
"type": "object", 
"allof": [ 
f 
" $ ref": "oic. core - schema. json # /def initions/oic.core" 
L 
" $ ref": "# /definitions/oic. collection" 
} 
] 
} 
example: | 


{ 
"rt": "oic. wk. sceneList", 
"n": "list of scene Collections", 
































"rts": "oic. wk. sceneCollection", 
"links": [ ] 
) 
2. 属性 定义 
属性 定义 如 表 9-20 所 示 。 
表 9-20 属性 定义 
属 性 名 | 属性 值 类 型 | 是 否 强制 dk 
links 多 类 型 
di 多 类 型 设备 ID 是 一 个 UUIDv4 FRAR, 用 于 与 规范 中 “/oic/res” 的 定义 向 后 兼容 
id 多 类 型 集合 ID 
. rx 定义 了 集合 中 包含 的 链接 中 允许 的 资源 类 型 (对 于 目标 和 锚 点 ) 的 列表 , 正 
i 在 创建 的 新 链接 只 能 来 自 此 列表 
drel ETT] 在 OCF 链接 未 通过 “rel" 参 数 指明 一 个 显 式 关系 时 ,指定 使 用 该 默认 关系 
3. CRUDN 行为 


CRUDN 行为 如 表 9-21 Bron 。 
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表 9-21 CRUDN 行为 
资 源 创建 检索 更 新 删除 通知 
/SceneListResURI get 


























9.11 场景 集合 


场景 集合 是 一 组 场景 建 模 的 集合 。 该 资源 是 具有 其 他 参数 的 通用 集合 资源 .“rts” 值 应 包含 
“oic, sceneMember” 资 源 类 型 ,附加 参数 是 "lastScene”, 是 最 后 由 任何 OCF 7€ P! 3i " sceneValueList" it 
置 的 场景 值 , 这 是 可 用 场景 的 列表 ,“lastScene” 应 该 列 在 “sceneValueList” 中 。URI 示例 为 
“/SceneCollectionResURI” ,资源 类 型 定义 为 *oic. wk. sceneCollection”。 

1. RAML 定义 


# % RAML 0.8 
title: Scene 
version: vl — 20160622 
traits: 
- interface : 
queryParameters: 
if: 
enum: ["oic. if.a", "oic. if.11", "oic. if. baseline" ] 
/SceneCol lect ionResURI: 
description: | 
Collection that models a set of Scenes. This resource is a generic collection resource with additional 
parameters. The rts value shall contain oic. sceneMember resource types. The additional parameters are 
lastScene, this is the scene value last set by any OIC Client sceneValueList, this is the list of 
available scenes lastScene shall be listed in sceneValueList. 
get: 
description: | 
Provides the current list of web links pointing to scenes 
responses : 
200: 
body: 
application/json: 
schema: | 


" $ schema": "http://json— schema. org/draft - 04/schema#", 

: "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved.", 
/openconnect ivityfoundat ion. org/core/schemas/oic. collection — schema. json#", 
Scene Collection", 

"definitions": { 
"oic. scenecollection": ( 
"type": "object", 
"properties": ( 
"lastScene": ( 
"type": "string", 
"description": "Last selected Scene, shall be part of sceneValues", 
"format": "UTF8" 
Lh 
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"sceneValues": ( 
"type": "string", 
"description": "ReadOnly, All available scene values", 
"format": "CSV" 
Lh 
"n: ( 
"type": "string", 
"description": "Used to name the Scene collection", 
"format": "UTF8" 
Lh 
"id": { 
"type": "string", 
"description" : "A unique string that could be a hash or similarly unique" 
) 
*xka i 
"type": "string", 
"description": "ReadOnly, Defines the list of allowable resource types in links 
included in the collection; new links being created can only be from this list", 
"format": "UTF8" 
h 
"links": { 
"type": "array", 
"description": "Array of OIC web links that are reference from this collection", 
"items" : { 
"allof": [ 
{ "$ ref": "oic.oic- link- schema. json # /definitions/oic. oic — link" }, 
{ "required" : [ "ins" ] } 
] 
} 
} 
) 
"required" : [" lastScene" , "sceneValues","rts","id" ] 


": "object", 
"allof" :[ 
{ "$ ref": "oic. core- schema. json# /def initions/oic.core" }, 
{ " $ ref": "#/definitions/oic. sceneCollection" } 
] 
} 
example: | 
{ 
"lastScene": "off", 
"sceneValues": "off, Reading, TVWatching", 
"rt": "oic. wk. sceneCollection", 
"n": "My Scenes for my living room", 
"id": "B— F- F — BEC — ECBDADC" , 
"rts": "oic. wk. sceneMenber" , 
"links": [ ] 
) 
post: 
description: | 
Provides the action to create a new sceneMember in the SceneCollection resource. The only resource type 
that is allowed to be created is "oic. wk. sceneMember". The id of the resource will be generated by the 
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implementation. As example the mappings of the scenes are mapped to different states of a binary switch. 
body: 
appl ication/json: 
schema: | 
{ 
" $ schema": "http://json— schema. org/draft — 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved.", 
"id" :" http: //openconnectivityfoundation. org/core/schemas/oic. sceneMember — schema. json#", 
"title" : "Scene Menber", 
"definitions": ( 
"oic. sceneMenber" : ( 
"type": "object", 
"properties": { 
"a": { 
"type": "string", 
"description": "Used to name the Scene collection", 
"format": "UTF8" 
h 
"id": { 
"type": "string", 
"description": "Can be an value that is unique to the use context or a UUIDv4" 
Lh 





"SceneMappings" : 
"type": "array", 
"description" :"array of mappings per scene, can be", 
"items": [ 
{ 
"type": "object", 
"properties": ( 
"scene": ( 
"type": "string", 
"description": "Specifies a scene value that will acted upon" 
) 
"memberProperty": ( 
"type": "string", 
"description": "ReadOnly, property name that will be mapped" 


"menberValue": ( 
"type": "string", 
"description": "ReadOnly, value of the Member Property" 
) 
)h 
"required": [ "scene", "memberProperty", "memberValue" ] 





"type": "string", 
"description": "web link that points at an resource", 
" $ ref": "oic.oic- link- schema. json#" 
} 
}, 
"required": [ "link" ] 
} 
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Lh 
"type": "object", 
"allo" : [ 


{ "$ ref": "oic. core- schema. json # /def initions/oic.core" }, 
{ "$ ref": "#/definitions/oic. sceneMember" ) ] } 
example: | 
{ 
"link": { "href" :"coap://mydevice/mybinaryswitch", 
"i£": “ois. .a 
"rt": "oic. r. switch. binary" }, 
"n": "my binary switch (for light bulb) mappings", 
"sceneMappings" : [ 
{ 
"scene": "off", 
"memberProperty": "value", 
"menberValue": true 
)h 
t 
"scene": "Reading", 
"menberProperty" : "value", 
"nemberValue": false 
}, 
{ 
"scene": "TVWatching", 
"memberProperty": "value", 
"memberValue": true 


) 
responses : 
200: 
description: | 
Indicates that the target resource was created. The new resource attributes are provided in the 
response. 
body: 
application/json: 
schema: | 
{ 
" $ schema": "http://json - schema. org/draft - 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved.", 
" id" :"http: //openconnect ivityfoundation. org/core/schemas/oic. sceneMember — schema. json#", 
"title" : "Scene Member", 
"definitions": { 
"oic. sceneMenber' 
"type": "object", 
"properties": ( 
*n*: { 
"type": "string", 
"description": "Used to name the Scene collection", 
"format": "UTF8" 
Lh 
"id": ( 





"description": "Can be an value that is unique to the use context or a UUIDv4" 
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Lh 
"SceneMappings" : ( 
"type": "array", 
"description": "array of mappings per scene, can be 1", 
"items": [ 
{ 
"type": "object", 
"properties": ( 
"scene": ( 
"type": "string", 
"description": "Specifies a scene value that will acted upon" 
Lh 
"menberProperty": ( 
"type": "string", 
"description": "ReadOnly, property name that will be mapped" 
Lh 
"nenberValue" : { 
"type": "string", 
"description": "ReadOnly, value of the Member Property" 





[ "scene", "memberProperty", "menberValue" ] 





"type": "string", 
"description": "web link that points at an resource", 
"$ ref": "oic.oic- link- schema. json # " 


) 
n 
"required": [ "link" ] 
) 
h 
"type": "object", 
"allof" : [ 


{ "$ ref": "oic. core— schema. json # /definitions/oic. core" }, 
{ " $ ref": "#/definitions/oic. sceneMember" } 
] 
H 
example: | 
{ 
"id": "0685B960 — FFFF - 46F7 — BECO — 9E6234671ADC1", 
"n": "ny binary switch (for light bulb) mappings", 
"link": ( "href" :"coap: //nydevice/mybinaryswitch", 
"if": "oic.if.a", 
"rt": "oic.r. switch. binary" }, 
"sceneMappings": [ 
{ 
"scene": "off", 
"memberProperty": "value", 
"memberValue": true 


Lh 
t 
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"scene" : "Reading", 
"nenberProperty": "value", 
"menberValue": false 
) 
{ 
"scene": "TVWatching", 
"memberProperty": "value", 
"menberValue": true 
$ 
] 
) 
put: 
description: | 
Provides the action to change the last settted scene selection. Calling this method shall update of all 
SceneMembers to the prescribed membervalue. 
When this method is called with the same value as the current lastScene value then all sceneMembers shall 
be updated. 
body: 
application/json: 
schema: | 
{ 
" $ schema": "http://json - schema. org/draft - 04/schema  ", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved. ", 
"id" : "http: //openconnectivityfoundation. org/core/schemas/oic. sceneCollection- schema. json#", 
"title" : "Scene Collection", 
"definitions": ( 
"oic. sceneCollection": { 
"type": "object", 
"properties": { 
"lastScene": ( 
"type": "string", 
"description": "Last selected Scene, shall be part of sceneValues", 
"format": "UTF8" 
Lh 
"sceneValues": { 
"type": "string", 
"description": "ReadOnly, All available scene values", 
"format": "CSV" 


"type": "string", 
"format": "UTF8" 


"type": "string", 
"description" : "A unique string that could be a hash or sinilarly unique" 


"type": "string", 

"description": "ReadOnly, Defines the list of allowable resource types in links included in 
the collection; new links being created can only be from this list", 

"format": "UTF8" 
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"type": "array", 
"description": "Array of OIC web links that are reference from this collection", 
"items" : { 
"allot": [ 
( " $ ref": "oic.oic- link- schema. json# /definitions/oic.oic- link" }, 
( "required" : [ "ins" ] } 
1 
) 
} 
} 
"required": [ "lastScene" ] 
} 
}, 
"type": "object", 
"allof" :[ 
{ " $ ref": "oic.core- schema. json# /definitions/oic.core" }, 
( " $ ref": " # /definitions/oic. sceneCollection" } 
] 
) 
example: | 
{ 
"lastScene": "Reading" 
) 




















2. 属性 定义 
属性 定义 如 表 9-22 所 示 。 
9-22 属性 定义 
属 性 名 | 属性 值 类 型 | 访问 模式 | 是 否 强制 LEE: 
lastScene 字符 串 读 写 是 最 后 选择 的 场景 ,应 该 是 “sceneValues” 的 一 部 分 
sceneValues 字符 串 只 读 是 所 有 可 用 的 场景 值 
n 字符 串 读 写 用 于 命名 场景 集合 
id us 读 写 是 一 个 唯一 的 字符 串 , 可 以 是 散 列 或 类 似 唯一 的 
定义 了 集合 中 包含 的 链接 中 允许 的 资源 类 型 (对 于 目标 

di aoe ug T 和 错 点 ) 列 表 , 正 在 创建 的 新 链接 只 能 来 自 此 列表 
links 数组 读 写 从 该 集合 中 引用 的 OCF 链接 数组 














3. CRUDN 行为 
CRUDN 行为 如 表 9-23 所 示 。 
表 9-23 CRUDN 行为 
资 源 创建 检索 更 新 删除 通知 
/SceneCollectionResURI get post 


























9.12 场景 成 员 


场景 成 员 建 模 为 一 个 “sceneMember” 的 集合 。URI 示例 为 /SceneMemberResURI” ,资源 类 型 定 
义 为 *oic. r. switch. binary”, 
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1. RAML 定义 


# % RAML 0.8 
title: Scene 
version: vl — 20160622 
traits: 
- interface : 
queryParameters: 
if: 
enum: ["oic. if.a", "oic. if.11", "oic. if. baseline"] 
/SceneMenberResURI : 
description: | 
Collection that models a sceneMenber. 
get: 
description: | 
Provides the scene member 
responses : 
200: 
body: 
application/json: 
schema: | 
{ 
" $ schema": "http://json - schema. org/draft - 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved. ", 
"id": "http: //openconnectivityfoundation. org/core/schemas/oic. collection - schema. json & ", 
"title": "Scene Collection", 
"definitions": { 
"oic. sceneMenber" : 
"type": "object", 
"properties": ( 
"ut 
"type": "string", 
"description": "Used to name the Scene collection", 
"format": "UTF8" 
}, 
“ie 
"type": "string", 
"description" : "Can be an value that is unique to the use context or a UUIDv4" 
Lh 
"SceneMappings" : ( 
"type": "array", 
"description": "array of mappings per scene, can be 1", 
"items": [ 
t 
"type": "object", 
"properties": ( 





"string", 
"description": "Specifies a scene value that will acted upon' 
) 
"memberProperty": ( 
"type": "string", 
"description": "ReadOnly, property name that will be mapped" 
B 
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"nenberValue": { 
"type": "string", 
"description": "ReadOnly, value of the Member Property" 





) 
B 
"required": [ "scene", "memberProperty", "memberValue” ] 
} 
1 
}, 
"link": ( 
"type": "string", 
"description": "web link that points at an resource", 
" $ ref": "oic.oic- link- schema. json#" 
) 
Lh 
"required": [ "link" ] 
) 
Lh 
"type": "object", 
"allof" : [ 
{ " $ ref": "oic.core- schema. json# /definitions/oic. core" }, 
{ "$ ref": "#/definitions/oic. sceneMenber" } 
] 
} 
example: | 
{ 


"id": "0685B960 — FFFF — 46F7 — BECO — 9E6234671ADC1", 
"n": "ny binary switch (for light bulb) mappings", 
"link": { "href" :"coap: //mydevice/nybinaryswitch", 
"if": "oic.if.a", 
"rt": "oic. r. switch. binary" }, 
"sceneMappings" : [ 
{ 
"scene" : "off", 
"nenberProperty": "value", 
"nemberValue": true 
}, 
{ 
"scene": "Reading", 
"nenberProperty": "value", 
"menberValue": false 
Lh 
t 
"scene": "TVWatching", 
"memberProperty": "value", 
"memberValue": true 


} 


2. 属性 定义 
属性 定义 如 表 9-24 所 示 。 
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表 9-24 属性 定义 

属 性 名 属性 值 类 型 访问 模式 是 否 强制 d xk 
n 字符 串 读 写 用 于 命名 场景 集合 
id 字符 串 读 写 可 以 是 对 使 用 上 下 文 或 UUIDv4 唯一 的 值 
sceneMappings 数组 读 写 每 个 场景 的 映射 数组 ,可 以 是 1 
scene 字符 串 读 写 是 指定 执行 操作 的 一 个 场景 
memberProperty 字符 串 只 读 是 被 映射 的 属性 名 
memberValue 字符 串 只 读 是 成 员 属性 的 值 
link 字符 串 读 写 是 指向 一 个 资源 链接 

3. CRUDN 行为 

CRUDN 行为 如 表 9-25 所 示 。 

表 9-25 CRUDN 行为 
资 源 创建 检索 更 新 删除 通知 





/SceneMemberResURI get 


9.13 资源 目录 资源 


资源 目录 资源 可 以 作为 资源 目录 ,是 被 设备 公开 的 资源 。 使 用 GET 请 求 提供 选择 器 标准 (例如 整 


数 ); 使 用 POST 请 求 在 “/oic/res” 中 发 布 或 更 新 链接 ; 使 用 DELETE 请 求 删除 “/oic/res” 中 的 链接 。 
URI 示例 为 */oic/rd”, 资 源 类 型 定义 为 ~oic. wk. rd”. 


1. RAML 定义 


# % RAML 0.8 
title: Resource Directory 
version: vl - 20160622 
traits: 
- rddelete- di : 
queryParameters: 
di: 
description: This is used to determine which set of links to operata on. (Need authentication to 
ensure that there is no spoof ing). If instance is ommitted then the entire set of links from this device ID is 
deleted. 
Example: DELETE /oic/rd?di = "0685B960 — 736F - 46F7 — BECO — 9E6CBD671ADC1" 
- rddelete- ins : 
queryParameters: 
ins: 
description: Instance of the link to delete Value of parameter is a string where instance to be 
deleted are comma separated. 
Example: DELETE /oic/rd?di = "0685B960 — 736F — 46F7 — BECO — 9E6CBD671ADC1"; ins = "20" 
- rdgetinterface : 
queryParameters: 
if: 
enum: ["oic. if. baseline" ] 
description: Interface is optional since there is only one interface supported for the Resource 
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Type. Both for RD selection and for publish. 
Example: GET /oic/rd?if = oic. if. baseline 
— rdpostinterface : 
queryParameters: 
rt: 
enun: ["oic. wk. rdpub" ] 
description: Used in POST request to ask the RD to add the Links in payload to /oic/res. 
Example: POST /oic/rd?rt = oic. wk. rdpub 
/oic/rd: 
description: | 
Resource to be exposed by any Device that can act as a Resource Directory. 
1) Provides selector criteria (e.g., integer) with GET request 
2) Publish or Update a Link in /oic/res with POST request 
3) Delete a Link in /oic/res with DELETE request 
get: 
description: | 
Get the attributes of the Resource Directory for selection purposes. 
is : [ 'rdgetinterface'] 


responses : 
200: 
description: | 
Respond with the selector criteria — either the set of attributes or the bias factor 
body: 
application/json: 
Schema: | 
{ 
" $ schema": "http: //json- schema. org/draft — 04/schema#", 
"description" : "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights 
reserved. ", 


"id": " http://www. openconnectivity. org/ocf — apis/core/schemas/oic. rd. selection — 
schema. json t ", 
"title" : "RD Selection", 
"definitions": ( 
"oic.rd.attributes": { 
"type": "object", 
"oneOf": [ 
t 
"properties": ( 
"sel": { 
"type": "integer", 
"minimum": 0, 
"maximum": 100, 
"description": "A bias factor calculated by the Resource directory - the 
value is in the range of 0 to 100 - 0 implies that RD is not to be selected. Client chooses RD with highest 
bias factor or randomly between RDs that have same bias factor" 


required": ["sel"] 


"properties": ( 
"sel": { 
"description": "Selection criteria that a device wanting to publish to any RD 
can use to choose this Resource Directory over others that are discovered", 





154 «|| OCF 技 术 原理 及 物 联网 程序 开发 指南 


"type": "object", 
"properties": { 
"per": { 
"type": "string", 
"enum" : [ "ac", "batt", "safe" ], 
"description": "A hint about how the RD is powered. If AC then this is 
stronger than battery powered. If source is reliable (safe) then appropriate mechanism for managing power 
failure exists" 


"enum": [ "wrd", "wrls" ], 
"description": "A hint about the networking connectivity of the RD. 
* wrd* if wired connected and * wrls* if wireless connected." 





"description": "Qualitative bandwidth of the connection", 
"enum": [ "high", "low", "lossy" ] 
Lh 
"af": { 
"type": "integer", 
"description": "Memory factor - Ratio of available memory to total 
memory expressed as a percentage" 





"ninItems": 3, 
"naxItenms": 3, 
"description": "Current load capacity of the RD. Expressed as a load 
factor 3- tuple (upto two decimal points each). Load factor is based on request processed in a 1 minute, 5 
minute window and 15 minute window" 
) 
} 
} 
Lh 
"required": ["sel"] 
) 


Lh 
": "object", 
"allof": [ 
{ " $ ref": "oic. core- schema. json# /definitions/oic.core" }, 
( " $ ref": " #/definitions/oic. rd. attributes" } 
] 
) 
example: | 
{ 
"rt": ["oic. wk. rd" ], 
"if": ["oic. if. baseline"], 
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"sel": 50 
} 
Post: 
description: | 

Publish the resource information for the first time or Update the existing one in /oic/res. 

Appropriates parts of the information, i.e., Links of the published Resources will be discovered 
through /oic/res. 

1) When a Device first publishes a Link, the request payload to RD may include the Links without "ins" 
Parameter. 

2) Upon granting the request, the RD assigns a unique instance value identifying the Link among all 
the Links it advertises and sends back the instance value in "ins" Parameter in the Link to the publishing 
Device. 

3) When later the publishing Device updates the existing Link, i. e., changing its Endpoint 
information, the request payload to RD needs to include the instance value in "ins" Parameter to identify the 
Link to update. 

is : ['rdpostinterface'] 


body: 
application/json: 
schema: | 
t 

" $ schema": "http: //json - schema. org/draft - 04/schena t ", 

"description": "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights 
reserved.", 

"id": "http://www. openconnectivity. org/ocf — apis/core/schemas/oic. rd. publish - schema. 
json#", 


"title": "RD Publish & Update", 
"definitions": { 
"oic. rd. publish": { 








"description": "Publishes resources as OIC Links into the resource directory", 
"properties": ( 
"ais 
" $ ref": "oic. types — schema. json # /def initions/uuid", 


"description": "A unique identifier for the publishing Device, i.e., its device ID" 
"links": ( 
jc WE 

"type": "integer", 

"description": "Time to indicate a RD, how long to keep this published item. After 


this time (in seconds) elapses, the RD invalidates the links. To keep link alive the publishing device updates 
the ttl using the update schema" 


: "object", 
"allof": [ 


" $ ref": "oic. core- schema. json # /definitions/oic. core" 


" $ ref": "#/definitions/oic. rd. publish" 
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"di": "e61c3e6b— 9c54 — 4b81 — 8ce5 — f9039c1d04d9", 
"links": [ 





"oct: //e61c3e6b — 9c54 — 4b81 — 8ce5 — £9039c1d04d9", 
"href": — "/nmyLightSwitch", 


xt"; ["oic. r. switch. binary" ], 
"a ["oic. if.a", "oic. if. baseline"), 
"p": {"bm": 3}, 
"eps": [ 


{"ep" :"coaps://[2001 :db8:a: :b1d6]:1111", "pri": 2}, 
{"ep": "coaps://[2001:db8:a: :bld6]:1122"}, 
{"ep": "coaps + tcp://[2001:db8:a: :123]:2222", "pri": 3} 





] 
}, 
{ 
"anchor": "ocf ://e61c3e6b— 9c54 — 4b81 - 8ce5 - f9039c1d04d9", 
"href": "/myLightBrightness", 
"rt": ["oic. r. brightness" ], 
"i"; ["oic.if.a", "oic. if. baseline" ], 
"p": {"bm": 3}, 
"eps": [ 
{"ep": "coaps://[ [2001 :db8:a: :123]:2222") 
] 
} 
L 
"ttl": 600 
} 
responses : 
200: 
description: | 


Respond with the same schema as publish but, when a Link is first published, with the additional " 
ins" Parameter in the Link. This value is used by the receiver to manage that OCF Link instance. 
body: 
application/json: 
schema: | 
{ 
" $ schema": "http: //;json- schema. org/draft — 04/schena#", 
"description": "Copyright (c) 2016, 2017 Open Connectivity Foundation, Inc. All rights 
reserved. ", 
"id": " http://www. openconnectivity. org/ocf — apis/core/schemas/oic. rd. publish — 
schema. json#", 
"title": "RD Publish & Update", 
"definitions": ( 
"oic. rd. publish": ( 
"description": "Publishes resources as OIC Links into the resource directory", 
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"properties" : { 
"di": { 
" $ ref": "oic. types - schema. json # /definitions/uuid", 
"description": "A unique identifier for the publishing Device, i.e., its device ID" 


" $ref": "oic. collection — schema. json # /def initions/oic. collection. 
setoflinks" 


"type": "integer", 

"description": "Time to indicate a RD, how long to keep this published item. After 
this time (in seconds) elapses, the RD invalidates the links. To keep link alive the publishing device updates 
the tt] using the update schema" 

} 
} 
} 
Lh 
"type" : "object", 
"allof":[ 
{ 
" $ ref": "oic. core - schema. json# /definitions/oic. core" 


) 
{ 


" $ ref": " & /definitions/oic. rd. publish" 








l 
"required": [ 
"di", 
"links", 
"ttl" 
] 
) 
example: | 
{ 
"di": "e61c3e6b — 9c54 - 4b81 - 8ce5 - £9039c1d04d9", 
"Hinks": ( 
{ 
"anchor": "ocf ://e61c3e6b - 9c54 - 4b81 - 8ce5 — £9039c1d04d9", 
"href": — "/myLightSwitch", 
"rt": ["oic. r. switch. binary"], 
"if": ["oic. if.a", "oic. if. baseline"], 
"p": {"bm": 3}, 
"eps": [ 
{"ep": "coaps://[2001:db8:a::b1d6]:1111", "pri": 2}, 
{"ep": "coaps://[2001:db8 1d6]:1122"), 
{"ep": "coaps + tcp://[2001:db8:a::123]:2222", "pri": 3) 
L 
“ing”: 13235" 
}, 
{ 


"anchor": "ocf://e61c3e6b — 9c54 — 4b81 — 8ce5 — £9039c1d04d9", 
"href": — "/myLightBrightness", 

"rt": ["oic. r. brightness" ], 

"if": ["oic. if.a", "oic. if. baseline" ], 
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"p: ("bn": 3), 


{"ep": "coaps://[2001:db8:a: :123]:2222"} 
L 
"ins": "112358" 
} 
l 
"ttl": 600 
} 
delete: 
description: | 
Delete a particular OIC Link - the link may be a simple link or a link in a tagged set. 
is : ['rddelete- di', 'rddelete - ins'] 
































responses : 
200: 
description: | 
The delete succeeded 
2. 属性 定义 
属性 定义 如 表 9-26 所 示 。 
表 9-26 属性 定义 
属 性 名 | 属性 值 类 型 | 访问 模式 | 是 否 强制 d 3 
sel 对 象 是 一 种 选择 器 标准 ,能 用 此 选择 在 其 他 可 发 现 资源 上 的 目录 
关于 RD 如 何 供电 的 提示 。 如 果 改 为 交流 电 ,那么 这 比 电 
pwr 字符 串 读 写 池 供 电 更 强 。 如 果 电 源 可 靠 (安全 ), 则 存在 用 于 管理 电源 
故障 的 适当 机 制 
关于 RD 的 网 络 连接 的 提示 。 如 果 是 有 线 连 接 , 则 为 
=e EN “wrd”; 如 果 是 无 线 连接 , 则 为 “wrls” 
bw 字符 串 读 写 连接 的 带宽 
mf 整 型 读 写 内 存 因子 一 一 可 用 内 存 与 总 内 存 之 比 ,以 百分比 表示 
load 数组 当前 RD 的 加 载 能 力 
3. CRUDN 行为 


CRUDN 行为 如 表 9-27 所 示 。 
表 9-27 CRUDN 行为 





资 源 创建 检索 更 新 删除 通知 




















/oic/rd get post delete 





9.14 图 标 
此 资源 描述 与 图 标 相关 联 的 属性 。URI 示例 为 /IconResURI” .资源 类 型 定义 为 “oic. r. icon”. 
1. RAML 定义 


Ë * RAML 0.8 
title: OICIcon 
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version: v1.1.0 一 20161107 
traits: 
— interface : 
queryParameters: 
if: 
enun: ["oic. if.r", "oic. if. baseline" ] 
/IconResURI: 
description: | 
This resource describes the attributes associated with an Icon. 
is : ['interface'] 
get: 
description: | 
Retrieves the current icon properties. 
responses : 
200: 
body: 
application/json: 
schema: | 
{ 
"id": "http://www. openconnectivity. org/ocf - apis/core/schemas/oic. r. icon. json#", 
" $ schema": "http: //json- schema. org/draft — 04/schema & ", 
"description" : "Copyright (c) 2017 Open Connectivity Foundation, Inc. All rights reserved.", 
"title": "Icon", 
"definitions": 
"oic.r. icon" 





"readOnly": true, 
"description": "Specifies the format of the MIME Type" 





"readOnly": true, 
"description": "Specifies the width in pixels" 
) 
"height": ( 
"type": "integer", 
"minimum": 1, 
"readonly": true, 
"description": "Specifies the height in pixels" 
) 
"media": { 
"type": "string", 
"maxLength": 256, 
"format" : "uri", 
"readOnly": true, 
"description": "Specifies the media URL to icon" 


Lh 
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"type": "object", 
"allof":[ 
( " $ ref": "oic. core - schema. json# /definitions/oic. core"}, 
{ " $ ref": " & /de£initions/oic. r. icon") 
] 
"required": ["mimetype", "width", "height", "media" ] 
} 
example: | 
{ 
"rt": ["oic.r. icon"], 
"id": "unique example id", 
"mimetype": "image/png", 
"width": 256, 
"height": 256, 
"media": "http://findbetter. ru/public/uploads/1481662800/2043. png" 
) 


























2. 属性 定义 
属性 定义 如 表 9-28 所 示 。 
表 9-28 属性 定义 
属 性 名 属性 值 类 型 访问 模式 是 否 强制 d xk 
mimetype 字符 串 Ri 是 规定 MIME 类 型 的 形式 
width 整 型 只 读 是 规定 宽度 像素 
media 字符 串 只 读 是 规定 媒体 URL 为 图 标 
height 字符 串 只 读 是 规定 高 度 像素 
3. CRUDN 行为 
CRUDN 行为 如 表 9-29 所 示 。 
表 9-29 CRUDN 行为 
% 0g 创建 检索 更 新 删除 通知 





/IconResURI get 


9.15 内 省 资源 


该 资源 提供 一 种 方法 ,去 获取 所 有 终端 设备 的 内 省 数据 。 该 资源 托管 的 URL 既 不 是 内 部 URL 也 
不 是 外 部 URL. URI 示例 为 */IntrospectionResURI” ,资源 类 型 为 “oic. wk. introspection” 
1. RAML 定义 


# % RAML 0.8 
title: OICIntrospection 
version: v1.0.0 — 20160707 
traits: 
— interface : 
queryParameters: 
if: 
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enum: ["oic. if.r", "oic. if.baseline"] 
/Introspect ionResURI: 
description: | 
This resource provides the means to get the device introspection data specifiying all the 
endpoints of the device. The url hosted by this resource is either a local or an external url. 
is : ['interface'] 


get: 
responses : 
200: 
body: 
application/json: 
schema: | 
{ 
"id": "http://www. openconnectivity. org/ocf — apis/core/schemas/oic. wk. introspectionInfo. 
json#", 
" $ schema": "http: //json - schema. org/draft — 04/schema#", 
"description" : "Copyright (c) 2017 Open Interconnect Consortium, Inc. All rights 
reserved. ", 


"title": "introspection resource", 
"definitions": ( 
"oic. wk. introspectionInfo": { 
"type": "object", 
"properties": ( 
"urlInfo": ( 
"type": "array", 
"description": "The valid range for the value Property", 
"readOnly" : true, 
"ninItens": 1, 
"itens": ( 
"type" : "object", 
"properties": { 
"url": ( 
"type": "string", 
"format": "uri", 
"description" : "url to download the description" 
}, 
"protocol": { 
"type": "string", 
"enum": [ "coap", "coaps", "http", "https", "coap * tcp", "coaps * tcp" ], 
"description" : "protocol to be used to download the introspection" 
}, 
"content - type": { 
"type": "string", 
"enun": [ "application/json", "application/cbor" ], 
"default" : "application/cbor", 
"description" : "content - type of the introspection data" 
Lh 
"version": ( 
"type": "integer", 
"enum": [ 1 ], 
"default" : 1, 
"description" : "version the introspection data that can be downloaded" 
) 
Lh 
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"required" : [ "url", "protocol"] 


"required" : ["urlInfo"] 


"type": "object", 
"allof": [ 
(" $ ref": "#/definitions/oic. wk. introspectionInfo"], 
(" $ ref": "oic.core- schema. json # /def initions/oic.core"] 

















] 
) 
example: | 
{ 
"rt" : ["oic. wk. introspection" ], 
"urlInfo" : [ 
{ 
"content - type" : "application/cbor", 
"protocol" : "coap", 
"url" : "coap://[fe80::1]:1234/IntrospectionExampleURI" 
) 
] 
) 
2. 属性 定义 
属性 定义 如 表 9-30 所 示 。 
表 9-30 属性 定义 
属 性 名 属性 值 类 型 访问 模式 是 否 强制 fi 3 
urlinfo 字符 串 RE 是 值 属性 的 可 获取 范围 
urlCurlinfo) 整 型 是 下 载 描述 的 URL 
content-type(urlinfo) 字符 串 内 省 数据 的 内 容 类 型 
version(urlinfo) 整 型 内 省 数据 的 版 本 
protocol(urlinfo) 字符 串 是 下 载 的 内 省 数据 所 使 用 的 协议 














3. CRUDN 行为 
CRUDN 行为 如 表 9-31 所 示 。 


# 9-31 CRUDN 行为 





资 源 创建 检索 更 新 删除 通知 





/IntrospectionResURI get 




















ae Swagger 定义 核心 资源 类 型 


CHAPTER 10 








Swagger 是 一 款 RESTful 接口 的 文档 在 线 自 动 生 成 、 功 能 测试 软件 。Swagger 可 以 生成 一 个 具有 
互动 性 的 API 控制 台 ,开发 者 可 以 用 来 快速 学 习 和 尝试 API。Swagger 可 以 生成 客户 端 SDK 代码 用 于 
各 种 平台 上 的 实现 ,本 章 介绍 OCF 对 Swagger 2.0 的 支持 代码 。 


10.1 





标 


此 资源 描述 与 图 标 相关 联 的 属性 ,检索 当前 的 图 标 属性 。URI 示例 为 “/IconResURI”, 被 定义 资源 
类 型 为 ~oic. r. icon", 
1, Swagger 2. 0 定义 


{ 
"swagger": "2.0", 
"info": { 
"title": "Icon", 
"version": "v1.1.0 - 20161107", 
"license": ( 

"name": "copyright 2016 - 2017 Open Connectivity Foundation, Inc. All rights reserved. ", 

"x - description": "Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met: Vn 1. Redistributions of source code must retain 
the above copyright notice, this list of conditions and the following disclaimer. Vn 2. Redistributions in 
binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer 
in the documentation and/or other materials provided with the distribution. \n\n THIS SOFTWARE IS PROVIDED BY 
THE Open Connectivity Foundation, INC. \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES OF 
NON — INFRINGEMENT, ARE DISCLAIMED. Vn IN NO EVENT SHALL THE Open Connectivity Foundation, INC. OR 
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 

) 
Lh 
"schemes": ["http"], 
"consumes": ["application/json"], 
"produces": ["application/json"], 
"paths": ( 

"/IconResURI" : ( 

"get": ( 
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"description": "This resource describes the attributes associated with an Icon. \nRetrieves the 
current icon properties. Vn", 
"parameters": [ 
(" $ ref": "+ /parameters/interface"} 


1, 
"responses": { 
"200": { 
"description" : "", 
"x— example”: 
{ 


"xt": ["oic.r. icon"], 

"id": "unique example id", 

"mimetype": "image/png", 

"width": 256, 

"height": 256, 

"media": "http://findbetter. ru/public/uploads/1481662800/2043. png" 
} 


"schema": ( " $ ref": " & /definitions/Icon" } 
) 


) 
"parameters": ( 
"interface" : { 





"definitions": { 
"Icon" : 
{ 
"properties": { 
"height": { 
"description": "Specifies the height in pixels", 
"minimum": 1, 
"readOnly" : true, 
"type": "integer" 
) 
"ad: 4 
"description": "Instance ID of this specific resource", 
"naxLength": 64 
"readOnly" : true, 
"type": "string" 


) 

mie" f 
"description": "The interface set supported by this resource", 
"items": { 


"enun": [ 
"oic. if. baseline", 
"oic. if.11", 
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"oic. if.b", 
"oic. if. 1b", 
oic. if. rw", 
oic. if. r", 
oic. if.a", 
oic. if. s" 


: "string" 


"ninItens": 1, 
"readOnly": true, 
"type": "array" 


"media": { 
"description": "Specifies the media URL to icon", 
"format": "uri", 
"maxLength" : 256, 
"readOnly": true, 
"type": "string" 


mimetype": ( 
"description": "Specifies the format of the MIME Type", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 





"er 
"description": "Friendly name of the resource", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 


}, 

"pet 
"description": "Resource Type", 
"items": ( 

"maxLength" : 64, 
"type": "string" 
) 
"ninItems": 1, 
"readOnly": true, 
"type": "array" 

) 

"width": ( 
"description": "Specifies the width in pixels", 
"minimum": 1, 
"readOnly": true, 
"type": "integer" 

) 

required": [ 

"mimetype", 

"width", 

"height", 


"media" 
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} 





























2. 属性 定义 
属性 定义 如 表 10-1 Bron 。 
表 10-1 属性 定义 

属 性 名 属性 值 类 型 访问 模式 是 否 强制 d æ 

width 整 型 只 读 是 指定 以 像素 为 单位 的 宽度 
rt 数组 RE 资源 类 型 

id 字符 串 只 读 规定 资源 的 示例 ID 
height Er] 只 读 是 指定 以 像素 为 单位 的 高 度 
mimetype 字符 串 只 读 是 指定 MIME 类 型 的 格式 
n 字符 串 只 读 资源 的 友好 名 称 

if 数组 只 读 该 资源 支持 的 接口 

media 字符 串 只 读 是 指定 媒体 URL 为 图 标 














3. CRUDN 行为 
CRUDN 行为 如 表 10-2 所 示 。 


# 10-2 CRUDN 行为 
Xo 3 创建 检索 更 新 删除 通知 
/IconResURI get 





10.2 内 省 资源 


该 资源 提供 一 种 方法 ,获取 所 有 终端 设备 的 内 省 数据 。 该 资源 托管 的 URL 既 不 是 内 部 URL ,也 不 
是 外 部 URL, URI 示例 为 */IntrospectionResURI” ,资源 类 型 为 “oic. wk. introspection” , 
1. Swagger 2. 0 定义 


{ 
"swagger": "2.0", 
"info": { 
"title": "Introspection Resource", 
"version": "v1.0. 0- 20160707", 
"license": { 
"name": "copyright 2016 — 2017 Open Connectivity Foundation, Inc. All rights reserved.", 
"x — description": "Redistribution and use in source and binary forms, with or without 
modification, are permitted provided that the following conditions are met:\n 1. Redistributions of source 
code must retain the above copyright notice, this list of conditions and the following disclaimer. Vn 2. 
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the 
following disclaimer in the documentation and/orother materials provided with the distribution. \n\n THIS 
SOFTWARE IS PROVIDED BY THE Open Connectivity Foundation, INC. V" AS IS\" AND ANY EXPRESS OR IMPLIED 
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
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PARTICULAR PURPOSE OR WARRANTIES OF NON — INFRINGEMENT, ARE DISCLAIMED. Vn IN NO EVENT SHALL THE Open 
Connectivity Foundation, INC. OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF 
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY 
WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 
) 
b 
"schemes": ["http"], 
"consumes" : ["application/json"], 
"produces": ["application/json"], 
"paths": { 
"/IntrospectionResURI" : { 
"get": ( 
"description": "This resource provides the means to get the device introspection data specifiying 
all the endpoints of the device. \nThe url hosted by this resource is either a local or an external url.\n", 
"parameters": [ 
(" $ ref": "+ /paraneters/interface") 
l 
"responses": { 
"200": { 
"description" : "", 
"x— example": 


{ 


rt" : ["oic. wk. introspection" ], 
"urlInfo" : [ 
{ 
"content - type" : "application/cbor", 
"protocol" : "coap", 
"url" : "coap://[fe80: :1]:1234/IntrospectionExampleURI" 
) 
] 
) 


"schema": ( " $ ref": " # /def initions/oic.wk. introspectionInfo" } 


H 
) 
"parameters": ( 
"interface" : 





"string", 





) 
"definitions": { 
"oic. wk. introspectionInfo" : 
{ 
"properties": { 
"id": { 
"description": "Instance ID of this specific resource", 
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"naxLength": 64, 
"readOnly": true, 
"type": "string" 


"description": "The interface set supported by this resource", 
"items": ( 
"enun": [ 
"oic. if. baseline", 
"oic. if.11", 
"oic. if.b", 
"oic. if.lb", 
oic. if. rw", 
oic.if.r", 
oic.if.a", 
oic.if.s" 
L 
"type": "string" 
}, 6869 
"minItems": 1, 
"readonly": true, 
"type": "array" 
Lh 
"a": { 
"description": "Friendly name of the resource", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 
) 
"rh: 
"description": "Resource Type", 
"items": ( 
"maxLength" : 64, 
"type": "string" 
B 
"minItems": 1, 
"readOnly": true, 
"type": "array" 
Lh 
"urlInfo": ( 
"description": "The valid range for the value Property", 
"items": { 
"properties": { 
"content - type": { 
"default": "application/cbor", 
"description": "content- type of the introspection data", 
"enun": [ 
"application/json", 
"application/cbor" 


: "string" 


"protocol": ( 
"description": "protocol to be used to download the introspection", 
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"enum": [ 
"coap", 
"coaps", 
"http", 
"https", 
"coap + tcp", 
"coaps + tcp" 


"type": "string" 


"description": "url to download the description", 
"format": "uri", 
"type": "string" 
) 
"version": ( 
"default": 1, 
"description": "version the introspection data that can be downloaded", 
"enun" : [ 
1 
1, 
"type": "integer" 


"protocol" 
l 
"type": "object" 
) 
"ninItens": 1, 
"readOnly": true, 
"type": "array" 
} 
) 
"required": [ 
"urlInfo" 
l 
"type": "object" 




















} 
) 
} 
2. 属性 定义 
属性 定义 如 表 10-3 所 示 。 
表 10-3 属性 定义 
属 性 名 属性 值 类 型 访问 模式 是 否 强 制 do xk 
if 数组 RE 该 资源 支持 的 接口 集合 
id 字符 串 只 读 此 特定 资源 的 实例 ID 
urlinfo 数组 RE L3 值 属性 的 可 获取 范围 
rt 数组 只 读 资源 类 型 
n 字符 串 只 读 资源 的 友好 名 称 

















170 || OCF 技 术 原 








及 物 联 网 程序 开发 指南 


3. CRUDN 行为 
CRUDN 行为 如 表 10-4 Bron 。 


表 10-4 CRUDN 行为 





资 源 创建 检索 更 新 删除 通知 





/IntrospectionResURI get 




















示 。 


10.3 OCF 集合 


OCF 集合 资源 类 型 包含 属性 和 链接 。*oic. if. baseline” 接 口 暴露 了 集合 资源 本 身 的 链接 和 属性 表 
URI 3R flH“ /CollectionBaselineInterfaceURI” ,资源 类 型 为 oic. wk. col”. 
1. Swagger 2. 0 定义 


{ 
"swagger": "2.0", 
"info": ( 
"title": "OCF Collection", 
"version": "1.0", 
"license": ( 
"name": "copyright 2016 - 2017 Open Connectivity Foundation, Inc. All rights reserved. ", 
"x - description": "Redistribution and use in source and binary forms, with or without modification, are 
permitted provided that the following conditions are met:\n 1. Redistributions of source code must retain the 
above copyright notice, this list of conditions and the following disclaimer. \n 2. Redistributions in binary 
form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the 
documentation and/or other materials provided with the distribution. \n\n THIS SOFTWARE IS PROVIDED BY THE 
Open Connectivity Foundation, INC. \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES OF 
NON — INFRINGEMENT, ARE DISCLAIMED. Vn IN NO EVENT SHALL THE Open Connectivity Foundation, INC. OR 
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 
} 
}, 
"schemes": ["http"], 
"consumes": ["application/json"], 
"produces": ["application/json"], 
"paths": ( 
"/CollectionBaselineInterfaceURI" : ( 
"get": { 

"description": "OCF Collection Resource Type contains properties and links. \nThe oic. if. baseline 
interface exposes a representation of \nthe links and the properties of the collection resource itself \ 
nRetrieve on Baseline Interface", 

"parameters": [ 

(" $ ref": "+ /paraneters/interface — baseline"] 

l 

"responses": ( 

"200": { 
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"description" : 
"x— example”: 
t 
"rt": ["oic. wk. col"], 
"id": "unique example id", 
"rts": [ "oic. r. switch. binary", "oic.r.airflow" ], 
"links": [ 
t 
"href": "switch", 
"rt": ["oic.r. switch. binary" ], 
"if": ["oic. if.a", "oic. if. baseline"], 
"eps": [ 





"coap: //[£e80: :b1d6] :1111", "pri": 2}, 
"coaps: //[£e80: :b1d6] :1122"),, 
(" ep": "coap + tcp://[2001:db8:a::123]:2222", "pri": 3} 





"href": "airFlow", 

"rt": ["oic.r.airflow"], 
"if": ["oic. if.a", "oic. if.baseline"], 

: "coap://[fe80: :b1d6] :1111", "pri": 2}, 

"coaps: //[fe80: :b1d6] :1122"),, 

p": "coap + tcp://[2001:db8:a::123]:2222", "pri": 3} 





"schema": ( " $ ref": " & /definitions/sbaseline" } 
) 
) 
» 
"post": { 
"description": "Update on Baseline Interface\n", 
"parameters": [ 
(" $ ref": "+ /paraneters/interface - baseline"), 
t 
"name": "body", 
"in": "body", 
"required": true, 
"schema": ( " $ ref": " & /definitions/sbaseline" } 
) 
l 
"responses": ( 
"200": ( 
"description" : "" 





"schema": ( " $ ref": "# /definitions/sbaseline" 
) 


} 
} 
Lh 
"/CollectionBatchInterfaceURI" : ( 
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"get": ( 

"description": "OCF Collection Resource Type contains properties and links. VnThe oic. if. b 
interfacce exposes a composite representation of the\nresources pointed to by the links VnRetrieve on Batch 
Interface\n", 

"parameters": [ 
(" $ ref": "+ /parameters/ interface — b"] 
1, 
"responses": { 
"200": { 
"description" : "All targets returned OK status (HTTP 200 or CoAP 2.05 Content)", 
"x— example": 
[ 
{ 


"href": "switch", 


"value": true 
}, 
{ 


"href": "airFlow", 
"rep": 
{ 
"direction": "floor", 
"speed": 3 
} 


] 
i 
"schema": { " $ ref": " & /definitions/sbatch- retrieve" } 
"404": ( 
"description" : "One or more targets did not return an OK status, return a representation 


containing returned properties from the targets that returned OK", 
"x- example": 


C 
{ 
"href": "switch", 
"rep": 
{ 
"value": true 
} 
} 
] 
"schema": ( " $ ref": "#/definitions/sbatch— retrieve" ) 
H 
) 
} 
"post": { 


"description": "Update on Batch Interface\n", 
"parameters": [ 

{" $ ref": " # /parameters/interface - b"}, 

t 


"name": "body", 
"in": "body", 
"required": true, 
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"schema": ( " $ ref": "# /definitions/sbatch— update" }, 


"x ~ example": 


[ 


t 
"href": "switch", 
"rep": 
t 
"value": true 
) 
L 
t 
"href": "airFlow", 
"rep": 
t 
"direction": "floor", 
"speed": 3 
) 
} 
] 
) 
l 
"responses" : ( 
"200": ( 
"description" : 


representation of the current state of all targets", 
"x— example": 


"all targets returned OK status (HTTP 200 or CoAP 2.04 Changed) return a 


[ 
{ 
"href": "switch", 
"rep" 
{ 
"value": true 
) 
}, 
{ 
"href": "airFlow", 
"rep": 
{ 
"direction": "demist", 
"speed": 5 
) 
) 
] 
"schema": ( " $ ref": "# /definitions/sbatch- retrieve" ) 
) 
"403": ( 
"description" : 


" one or more targets did not return OK status; return a retrieve 


representation of the current state of all targets in the batch", 


"x— example": 


[ 
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{ 
"href": "switch", 


"value": true 
Lh 
t 


"href": "airFlow", 
"rep": 
t 
"direction": "floor", 
"speed": 3 
) 
} 
] 
"schema": { " $ ref": " & /definitions/sbatch- retrieve" } 
) 
) 
) 
Lh 
"/CollectionLinkListInterfaceURI" : { 
"get": ( 


"description": "OCF Collection Resource Type contains properties and links. VnThe oic. if. 


interface exposes a representation of the links\nRetrieve on Link List Interface\n", 
"parameters": [ 
(" $ ref": "+ /paraneters/interface - 11") 


l 
"responses" : ( 
"200": ( 
"description" : "", 
"x— example": 
[ 
f 


"href": "switch", 
"rt": ["oic.r. switch. binary" ], 
if": ["oic. if.a", "oic. if. baseline" ], 
"eps": [ 
{"ep": "coap://[£e80::bid6]:1111", "pri": 2), 
{"ep": "coaps://[£e80: :bid6]:1122"}, 
{"ep": "coap + tep://[ 2001 :db8:a: :123]:2222", "pri": 3) 
] 


" 


"href": "airFlow", 
"rt": ["oic. r. airflow"], 
"if": ["oic. if.a", "oic.if.baseline"], 
"eps": [ 

{"ep": "coap: //[£e80: :b1d6] :1111", "pri": 2}, 

{"ep": "coaps://[£fe80: :b1d6]:1122"], 

{"ep": "coap + tcp: //[2001:db8:a::123]:2222", "pri": 3} 
] 





} 


1l 
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] 


"schema": ( " $ ref": " # /definitions/slinks" } 
) 
) 
) 
} 
B 
"parameters": { 
"interface— 11" : { 
"in" : "query", 
"if", 
"string", 
["oic. if.11"] 





) 


"interface- b" : ( 





enun" ; ["oic.if.b"] 
) 
"interface- baseline" : { 
"in" : "query", 
"name" : "if", 
"string", 
enum ["oic. if. baseline" ] 





) 
"interface- all" : { 
"in" : "query", 
"name" ; "if", 
"string", 
"oic. if.11", "oic. if. baseline", "oic. if.b"] 





Lh 
"definitions": ( 
"sbaseline" : 
t 
"description": "A set (array) of simple or individual OIC Links. In addition to properties required 
for an OIC Link, the identifier for that link in this set is also required", 
"items": ( 
"properties": ( 
"anchor" : ( 
"description": "This is used to override the context URI e.g. override the URI of the 
containing collection", 
"format": "uri", 
"maxLength" : 256, 
"type": "string" 
Lh 
"di": ( 
"description": "Unique identifier for device (UUID)", 
"pattern": "^[a- fA— F0 - 9](8) - [a- fA- F0 - 9](4] - [a- fA— F0-9](4] - [a- fA- F0- 9] 
{4} - [a- fa- FO - 9](12) $", 
"type": "string" 
}, 
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"drel": { 
"description": "When specified this is the default relationship to use when an OIC Link does 
not specify an explicit relationship with * rel* parameter", 
"type": "string" 


Lh 
"eps": ( 
"description": "the Endpoint information of the target Resource", 
"items": ( 
"properties": ( 
"ep": { 
"description": "URI with Transport Protocol Suites + Endpoint Locator as specified", 
"format": "uri", 
"type": "string" 
Lh 
"pri": { 
"description": "The priority among multiple Endpoints as specified", 
"minimum": 1, 
"type": "integer" 
) 
h 
"type": "object" 
}, 
"type": "array" 
) 
"href": { 


"description": "This is the target URI, it can be specified as a Relative Reference or fully 
- qualified URI. Relative Reference should be used along with the di parameter to make it unique.", 

"format": "uri", 

"naxLength": 256, 

"type": "string" 


} 

"id": { 
"description": "Instance ID of this specific resource", 
"maxLength" : 64, 


"readOnly": true, 
"type": "string" 
) 
"if": { 
"description": "The interface set supported by this resource", 
"items": { 
"^ "ul 
"oic. if. baseline", 
"oic. if.11", 
"oic.if.b", 
oic.if.rw", 
oic.if.r", 
"oic.if.a", 
“oie, if. a" 


: "string" 
"ninItens": 1, 


"type": "array" 


B 
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"ins": ( 
"description": "The instance identifier for this web link inan array of web links — used in 
collections", 
"oneof": [ 
t 


"description": "An ordinal number that is not repeated - must be unique in the 

collection context", 
"type" 

) 

t 





" integer" 


"description": "Any unique string including a URI", 
"format": "uri", 
"naxLength": 256, 
"type": "string" 
Lh 
t 
"description": "Unique identifier (UUID)", 
"pattern": "^[a- fA- F0 - 9](8) - [a- £A- F0 - 9](4] - [a - fA- F0 - 9](4) - [a- fA- FO 
-9]{4} - [a- fA- FO - 9](12) $", 
"type": "string" 


"links": ( 
"description": "All forms of links in a collection", 
"oneOf": [ 
{ 
"description": "A set (array) of simple or individual OIC Links. In addition to 
properties required for an OIC Link, the identifier for that link in this set is also required", 
"items": { 
"properties": { 
"anchor": ( 
"description": "This is used to override the context URI e.g. override the URI of 
the containing collection", 





"description": "Unique identifier for device (UUID)", 
"pattern": "*[a— fA- F0 - 9](8) - [a- fA- F0 - 9](4) - [a- fA FO - 9](4) - [a— 
fA- F0 - 9](4) - 7367[a- fA- FO - 9](12) $", 
"type": "string" 
}, 


"eps": ( 
"description": "the Endpoint information of the target Resource", 
"items": { 
"properties": { 
"ep": { 


"description": "URI with Transport Protocol Suites + Endpoint Locator as 
specified", 
"format": "uri", 
"type": "string" 
Lh 
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"pri": { 
"description": "The priority among multiple Endpoints as specified", 
"minimum": 1, 
"type": "integer" 


) 
Lh 
"type": "object" 
Lh 
"type": "array" 
}, 
"href": { 


"description": "This is the target URI, it can be specified as a Relative 
Reference or fully- qualified URI. Relative Reference should be used along with the di parameter to make it 
unique. ", 

"format": "uri", 

"maxLength" : 256, 

"type": "string" 


} 

"dg": d 
"description": "The interface set supported by this resource", 
"items": ( 





.baseline", 





"description": "The instance identifier for this web link in an array of web links 
— used in collections", 
"oneOf" : [ 
{ 


"description": "An ordinal number that is not repeated — must be unique in 
the collection context", 
"type": "integer" 
Lh 
t 
"description": "Any unique string including a URI", 
"format": "uri", 
"maxLength": 256, 
"type": "string" 
Lh 
{ 


"description": "Unique identifier (UUID)", 
"pattern": "^[a- fA- F0  9](8) - [a- fA- F0 - 9](4) - [a- fA- F0- 9](4) — 
[a- £A- F0 - 9](4) - [a- fA- F0 -9](12) $", 
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"type": "string" 


} 
"p": { 
"description": "Specifies the framework policies on the Resource referenced by 
the target URI", 
"properties": { 
"ba": ( 
"description": "Specifies the framework policies on the Resource referenced 
by the target URI for e.g. observable and discoverable", 
"type": "integer" 
) 
Lh 
"required": [ 
"ba" 
1, 
"type": "object" 
) 
"rel": { 
"description": "The relation of the target URI referenced by the link to the 
context URI", 
"oneOf": [ 
{ 
"default": [ 
"hosts" 


items": ( 
"maxLength": 64, 
"type": "string" 
} 
"minItems": 1, 
"type": "array" 
Lh 
{ 
"default": "hosts", 
"maxLength" : 64, 
"type": "string" 
} 
] 
}, 
sree 
"description": "Resource Type", 
"items": { 
"maxLength": 6: 
"type": "string" 
Lh 
"ninItems": 1, 
"type": "array" 


"title": ( 
"description": "A title for the link relation. Can be used by the UI to provide a 
context", 


"maxLength": 64, 
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"default": "application/cbor", 
"description": "A hint at the representation of the resource referenced by the 
target URI. This represents the media types that are used for both accepting and emitting", 
"items": ( 
"maxLength" : 64, 
"type": "string" 


: "object" 


: "array" 


*n*r4 

"description": "Friendly name of the resource", 

"maxLength" : 64, 

"readOnly": true, 

"type": "string" 
} 
"Pd 

"description": "Specifies the framework policies on the Resource referenced by the target URI", 

"properties": ( 

"ba": ( 
"description": "Specifies the framework policies on the Resource referenced by the 
target URI for e.g. observable and discoverable", 
"type": "integer" 





}, 
"rel": ( 
"description": "The relation of the target URI referenced by the link to the context URI", 
"oneOf" : [ 
t 
"default": [ 
"hosts" 
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"default": "hosts", 
"maxLength": 64, 
"type": "string" 


"rt": { 
"description": "Resource Type", 
"items": { 
"maxLength" : 64, 
"type": "string" 
Lh 
"ninItems": 1, 
"type": "array" 
n 
"rts": 
"description": "Defines the list of allowable resource types (for Target and anchors) in 
links included in the collection; new links being created can only be from this list", 
"items": ( 





type": "array" 


"title": ( 
"description": "A title for the link relation. Can be used by the UI to provide a context", 
"maxLength": 64, 
"type": "string" 
}, 
"type" : ( 
"default": "application/cbor", 
"description": "A hint at the representation of the resource referenced by the target URI. 
This represents the media types that are used for both accepting and emitting", 
"items": ( 
"naxLength" : 64, 
"type": "string 
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"type": "array" 


} 
"sbatch- retrieve" : 
t 
"itens": ( 
"additionalProperties": true, 
"properties": ( 
"href": { 
"description": "URI of the target resource relative assuming the collection URI as anchor", 
"format": "uri", 
"maxLength" : 256, 
"type": "string" 
L 
"rep": ( 
"oneOf": [ 
{ 
"description": "The response payload from a single resource", 
"type": "object" 
n 
{ 
"description": " The response payload from a collection (batch) resource", 
"type": "array" 
) 
] 
) 
Lh 
"required": [ 
"href", 
"rep" 
L 
"type" : "object" 
}, 
"minItems": 1, 
"type": "array" 
} 
"sbatch- update" : 


{ 

"description": "array of resource representations to apply to the batch collection, using href to 
indicate which resource(s) in the batch to update. If the href property is empty, effectively making the URI 
reference to the collection itself, the representation is to be applied to all resources in the batch", 

"itens": ( 

"additionalProperties": true, 
"properties": ( 
"href": ( 
"description": "URI of the target resource relative assuming the collection URI as anchor", 
"format": "uri", 
"naxLength" : 256, 
"type": "string" 
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"description": "The response payload from a single resource", 
"type": "object" 
h 
{ 
"description": " The response payload from a collection (batch) resource", 
"type": "array" 





} 
"slinks" : 
{ 
"description": "All forms of links in a collection", 
"oneOf": [ 


t 
"description": "A set (array) of simple or individual OIC Links. In addition to properties 
required for an OIC Link, the identifier for that link in this set is also required", 
"items": ( 
"properties": ( 
"anchor" : ( 
"description": "This is used to override the context URI e.g. override the URI of the 
containing collection", 
"format": "uri", 
"naxLength" : 256, 
"type": "string" 
Lh 
"di": 
"description": "Unique identifier for device (UUID)", 
"pattern": "^[a- fA- F0 - 9](8) - [a- £A F0 - 9](4) - [a- fA- F0 - 9](4) - [a- fA- 
FO -9](4) - [a- fA- F0 - 9](12) $", 
"type": "string" 


}, 
"eps": { 
"description": "the Endpoint information of the target Resource", 
"items": ( 
"properties": ( 
"ep": { 


"description": "URI with Transport Protocol Suites * Endpoint Locator as specified", 
"format": "uri", 
"type": "string" 

h 

"pri": { 
"description" :"The priority among multiple Endpoints as specified ", 
"minimum": 1, 
"type": "integer" 
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) 
n 
"type": "object. 
}, 
"type": "array" 
Lh 
"href": ( 


"description": "This is the target URI, it can be specified as a Relative Reference or 
fully- qualified URI. Relative Reference should be used along with the di parameter to make it unique. ", 
"format": "uri", 


"maxLength": 256, 
"type": "string" 
) 
"if": { 
"description": "The interface set supported by this resource", 
"items": ( 
"enum": [ 
"oic. if. baseline", 


P e 





"ninItens": 1, 
"type": "array" 
) 
"ins": ( 
"description": "The instance identifier for this web link in an array of web links — 
used in collections", 
"oneOf" : [ 
t 
"description": "An ordinal number that is not repeated - must be unique in the 
collection context", 
"type": "integer" 
Lh 
t 


"description": "Any unique string including a URI", 
"format": "uri", 
"naxLength": 256, 
"type": "string" 
)h 
{ 


"description": "Unique identifier (UUID)", 

"pattern": "^[a- fA- F0- 9] (8) - [a- fA- F0 - 9](4) - [a - £A F0 - 9](4] - [a 
£A - F0-9](4) - [a- fA- F0 -9](12) $ ", 

"type": "string" 
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"description": "Specifies the framework policies on the Resource referenced by the target 
URI", 
"properties": ( 
"ba": ( 
"description": "Specifies the framework policies on the Resource referenced by the 
target URI for e.g. observable and discoverable", 
"type": "integer" 


rel": { 


"oneOf": [ 


"hosts" 


"minItems": 1, 7 
"type": "array" 7 
Lh 
{ 
"default": "hosts", 
"naxLength": 64, 
"type": "string" 


"description": "Resource Type", 
"items": ( 

"maxLength" : 64, 

"type": "string" 


minltens": 1, 


"title": ( 

"description": "A title for the link relation. Can be used by the UI to provide a context", 
"maxLength" : 64, 
"type": "string" 

h 

"type": ( 
"default": "application/cbor", 
"description": "A hint at the representation of the resource referenced by the target 

URI. This represents the media types that are used for both accepting and emitting", 

"items": ( 
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"maxLength" : 64, 
"type": "string" 
} 


"minItems": 1, 


"type": "object" 
} 
"type": "array" 
) 
] 
) 
) 
) 




































































2. 属性 定义 
属性 定义 如 表 10-5 所 示 。 
表 10-5 属性 定义 
m 性 名 | 属性 值 关 型 | 访问 模式 | 是 否 强制 mox 
Tinks ZRN 集合 中 链接 的 所 有 形式 
n 数组 是 ”| 资源 类 型 
n 字符 审 RE 资源 的 友好 名 称 
Hs 数组 只 读 定义 在 集合 中 的 链接 里 允许 的 资源 列表 
id 字符 审 只 读 指定 资源 的 示例 ID 
di 多 类 型 设备 唯一 身份 符号 
aap 当 指 定时 ,这 是 OCF 链接 未 指定 与 "Tej" 参 数 的 显 式 关系 
时 使 用 的 默认 关系 
oe n 目标 资源 的 终端 信息 
title ET] 链接 关系 的 标题 
rep 多 类 型 是 
p x. 规定 从 目标 URI 引用 资源 的 框架 策略 
ins 多 类 型 集合 中 使 用 链接 数组 的 Web 实例 标识 符 
这 是 目标 URT, 它 可 以 被 指定 为 相对 引用 或 完全 限定 的 
t inii 是 。 | URI. 应 该 与 “di" 参 数 一 起 使 用 使 其 能 够 唯一 
E ERE 内 容 URI 的 链接 引用 目标 URI 的 关系 
= oe 提示 直 目 标 URI 引 用 的 资源 表示 ,这 表示 用 于 接收 和 发 
送 的 媒体 类 型 
na 3H 用 于 柳 盖 内 容 URL Blin, Wa aa RAH URI 
if 数组 是 | 该 资 源 支持 的 接口 
3. CRUDN 行为 


CRUDN 行为 如 表 10-6 所 示 。 
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# 10-6 CRUDN 行为 
资 源 创建 检索 更 新 删除 通知 


/CollectionBaselineInterfaceURI get post 


























10.4 平台 配置 


该 资源 允许 平台 配置 指定 信息 , 检索 当前 平台 配置 信息 。URI 示 例 为 “/example/ 
PlatformConfigurationResURI” ,资源 类 型 为 “oic. wk. con. p". 
1. Swagger 2. 0 定义 


t 
"swagger" : "2.0", 
"info": { 
"title": "Platform Configuration", 
"version": "vl 20160622", 
"license": { 

"name": "copyright 2016 - 2017 Open Connectivity Foundation, Inc. All rights reserved.", 

"x - description": "Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met:\n 1. Redistributions of source code must retain 
the above copyright notice, this list of conditions and the following disclaimer. Vn 2. Redistributions in 
binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer 
in the documentation and/or other materials provided with the distribution. \n\n THIS SOFTWARE IS PROVIDED BY 
THE Open Connectivity Foundation, INC. V"AS ISV" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES OF 
NON — INFRINGEMENT, ARE DISCLAIMED. \ n IN NO EVENT SHALL THE Open Connectivity Foundation, INC. OR 
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 

) 
)h 
"schemes": ["http"], 
"consumes": ["application/json"], 
"produces": ["application/json" ], 
"paths": { 
"/example/PlatformConf igurationResURI" : { 
m 
"description": "Resource that allows for platform specific information to be configured. V 
nRetrieves the current platform configuration settings in", 
"parameters": [ 
(" $ ref": " # /parameters/interface - all") 
L 
"responses": { 
"200": ( 
"description" : "", 
"x — example": 
{ 


"rt": ["oic. wk. con. p"], 
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"mnpn": [ ( "language": "en", "value": "My Friendly Device Name" ) ] 
} 


"schema": ( " $ ref": "#/definitions/Conf_Platform" } 


"post": ( 
"description": "Update the information about the platform\n", 
"parameters": [ 
(" $ ref": " # /paraneters/interface - rw"), 
"name": "body", 
"in": "body", 
"required": true, 
"schema": ( " $ ref": " # /definitions/Update Platform" }, 
"x - example”: 
{ 
"n": "Nuevo nombre", 
"mnpn": [ { "language": "es", "value": "Nuevo nombre de Plataforma Amigable" ) ] 


) 
1, 
"responses": { 
"200": { 
"description" : "", 
"x- example": 
{ 
"n": "Nuevo nombre", 
"mnpn": [ ( "language": "es", "value": "Nuevo nombre de Plataforma Amigable" } ] 
) 


k 
"schema": { " $ ref": " # /definitions/Update_Platform" } 
) 
) 
) 

} 
) 
"parameters": { 

"interface- rw" : ( 


"interface- all" : { 
"jin" : "query", 
"name" : "if", 
"type" : "string", 
"enun" : ["oic. if.rw", "oic.if.baseline"] 
} 
) 
"definitions": { 
"Conf Platform" : 
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{ 
"properties": { 
Mads 4 


"description": "Instance ID of this specific resource", 
"maxLength": 64, 
"readOnly" : true, 
"type": "string" 

) 

"if": { 
"description": "The interface set supported by this resource", 
"items": { 


"oic. if. baseline", 
"oic. if.11", 
oic.if.b", 
"oic.if.lb", 
"oic.if.rw", 
"oic.if.r", 
"oic.if.a", 
"oic.if.s" 


: "string" 
Lh 

"ninItems": 1, 
"readOnly": true, 
"type" : "array" 


"description": "Platform names", 
"items": { 
"properties": { 
"language": { 
"description": "An RFC 5646 language tag.", 
"pattern": "^[A- Za- z]{1,8}( - [A- Za- z0- 9]{1,8}) * $", 
"type": "string" 


value": { 

"description": "Platform description in the indicated language. ", 
"maxLength": 64. 

"type": "string" 


"a": d 
"description": "Friendly name of the resource", 
"maxLength": 64 
"readOnly": true, 
"type": "string" 
B 
Merc: 
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"description": "Resource Type", 
"items": { 
"maxLength" : 64, 
"type": "string" 
Lh 
"ninItens": 1, 
"readOnly": true, 
"type": "array" 
} 
Lh 
"type": "object" 
) 


"Update Platform" : 
{ 
"properties": ( 
"id": ( 
"description": "Instance ID of this specific resource", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 
n 
vig" eq. 
"description": "The interface set supported by this resource", 
"itens": ( 


"oic.if.baseline", 
"oic. if. 11", 


minItems": 1, 


"description": "Platform names", 
"items": { 
"properties": { 
"language": { 
"description": "An RFC 5646 language tag.", 
"pattern": "[A-Za- z](1,8)( - [A- Za- zo - 9](1,8)) * $", 
"type": "string" 


value": { 

"description": "Platform description in the indicated language. ", 
"maxLength": 64, 

"type": "string" 
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} 
Lh 
"type": "object" 
hn 


"minItems": 1, 


"description": "Friendly name of the resource", 
"maxLength" : 64, 
"type": "string" 


"description": "Resource Type", 
"items": ( 
"maxLength": 64, 
"type": "string" 
}, 
"minItems": 1, 
"readOnly": true, 
"type": "array" 


"type": "object" 

















) 
) 
) 
2. 属性 定义 
属性 定义 如 表 10-7 所 示 。 
表 10-7 属性 定义 
属 性 名 属性 值 类 型 访问 模式 是 否 强制 fi 3k 
mnpn 数组 平台 名 称 
if 数组 Ri 资源 支持 的 接口 集合 
rt 数组 只 读 资源 类 型 
id 字符 串 Ri 指定 资源 的 ID 示例 
n 字符 串 只 读 资源 的 友好 名 称 

















3. CRUDN 行为 
CRUDN 行为 如 表 10-8 所 示 。 


表 10-8 CRUDN 行为 





资 源 创建 检索 更 新 删除 通知 





/example/PlatformConfigurationResURI get post 
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10.5 设备 配置 


该 资源 允许 配置 设备 特定 信息 , 检索 当前 设备 配置 信息 。URI 示例 为 “/example/ 
DeviceConfigurationResURI” ,资源 类 型 为 “oic. wk. com", 
1. Swagger 2. 0 定义 


t 
"swagger" : "2.0", 
"info": { 
"title": "Device Configuration", 
"version": "vl - 20160622", 
"license": ( 

"name": "copyright 2016 - 2017 Open Connectivity Foundation, Inc. All rights reserved.", 

"x - description": "Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met:\n 1. Redistributions of source code must retain 
the above copyright notice, this list of conditions and the following disclaimer. Vn 2. Redistributions in 
binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer 
in the documentation and/or other materials provided with the distribution. \n\n THIS SOFTWARE IS PROVIDED BY 
THE Open Connectivity Foundation, INC. V"AS ISV" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES OF 
NON — INFRINGEMENT, ARE DISCLAIMED. Vn IN NO EVENT SHALL THE Open Connectivity Foundation, INC. OR 
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 

} 
} 
"schemes": ["http"], 
"consumes": ["application/json"], 
"produces": ["application/json"], 
"paths": ( 
"/exanple/DeviceConfigurationResURI" : { 
"get": ( 
"description": "Resource that allows for Device specific information to be configured. \nRetrieves 
the current Device configuration settings\n", 
"parameters": [ 
(" $ ref": "+ /paraneters/interface - all") 


1, 
"responses": { 
"200": { 
"description" : "", 
"x— example": 
t 


"n": "My Friendly Device Name", 
rt": ["oic.wk.con"], 

"loc": [32.777, - 96.797], 
"locn": "My Location Name", 
"c": "USD", 

"r": "MyRegion", 

"dl": "en" 
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"schema": ( " $ ref": " & /definitions/Configuration" } 
) 
) 
) 
"post": ( 
"description": "Update the information about the Device\n", 
"parameters": [ 
(" $ ref": " & /paraneters/interface — rw"), 
i: 
"nane": "body", 
"in": "body", 
"required": true, 
"schema": ( " $ ref": " & /definitions/Update" }, 
"x - example”: 


{ 
"n": "Nuevo Nombre Anistoso", 
"r": "MyNewRegion", 
"In": [ ( "language": "es", "value": "Nuevo Nombre Amistoso" ) ], 
"dl": "es" 
) 
} 
1, 
"responses": { 
"200": ( 
"description" : "", 
"x- example": 
{ 
"n": "Nuevo Nombre Amistoso", 
"r": "MyNewRegion", 
"In": [ ( "language": "es", "value": "Nuevo Nombre Amistoso" ) ], 
"dl": "eg" 
} 
"schema": { "$ ref": "#/definitions/Update” } 
} 
} 
} 
; 
) 


"parameters": ( 
"interface- rw" : 
"in" : "query", 
"if", 
string", 
enun" : ["oic. if. rw"] 








Lh 
"interface- all" : { 
"in" : "query", 
"name" : "if", 
"type" : "string", 
"enun" : ["oic. if.rw", "oic.if.baseline"] 
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}, 
"definitions": { 
"Configuration" : 
{ 
"properties": { 
"es { 
"description": "Currency", 


"maxLength": 64, 
"type": "string" 
b 
"dl": { 


"description": "Default Language", 
"pattern": "[A-Za- z](1,8)( -[A- Za- z20- 9](1,8)) * $", 
"type": "string" 
) 
"id": ( 
"description": "Instance ID of this specific resource", 
"naxLength" : 64, 


"Ogg 
"description": "The interface set supported by this resource", 
"items": ( 
"enun": [ 
"oic. if. baseline", 
"aic. if.11", 
"oic.if.b", 
"oic. if. lb", 
oic. if. rw", 
oic.if.r", 
oic.if.a", 
oic.if.s" 
1, 
"type 
Lh 
"ninItens": 1, 
"readOnly": true, 
"type": "array" 


: "string" 


b 
"In": { 
"description": "Localized names", 
"items": ( 
"properties": { 
"language": { 


"description": "An RFC 5646 language tag.", 
"pattern": ""[A- Za- z](1,8)( -[A- Za- z0- 9]{1,8}) * $", 
"type": "string" 


Lh 

"value": ( 
"description": "Device description in the indicated language. ", 
"naxLength": 64, 


"type": "string" 
} 
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Lh 
"type": "object" 
L 
"ninItens": 1, 
"type": "array" 
Lh 
"loc": { 
"description": "Location information", 
"itens": ( 
"type": "number" 
) 


"naxItens": 2, 
ninItens": 2, 


"locn": ( 
"description": "Human Friendly Name for location", 
"maxLength" : 64, 
"type": "string" 
Lh 
"n" id 
"description": "Friendly name of the resource", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 


So ef 

"description": "Region", 
"maxLength": 64, 

"type": "string" 
) 


"items": ( 


minItems": 1, 


type": "array' 
) 
}, 
"required": [ 
"n" 
l 
"type": "object" 
{ 
"properties": { 
lur! 


"description": "Currency", 
"naxLength": 64, 
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k A 
"description": "Default Language", 
"pattern": "^[A- Za- z]{1,8}( - [A- Za- z0- 9](1,8)) * $", 
"type": "string" 
B 
"id": { 
"description": "Instance ID of this specific resource", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 
)h 
"if": { 
"description": "The interface set supported by this resource", 
"items": { 
"enu": [ 
"oic. if. baseline", 
"oic. if.11", 


n 

"minItems": 1, 
"readonly": true, 
: "array" 


"An": d 
"description": "Localized names", 
"items": ( 
"properties": ( 
"language": { 
"description": "An RFC 5646 language tag.", 
"pattern": "[A-Za- z](1,8]( - [A- Za- 20- 9](1,8)) * $", 
"type": "string" 


value": ( 

"description": "Device description in the indicated language.", 
"maxLength" : 64. 

"type": "string" 


"loc": ( 
"description": "Location information", 
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"items": ( 

"type": "nunber" 
1, 
"naxItens": 2, 
"ninItens": 2, 


"locn": { 
"description": "Human Friendly Name for location", 
"maxLength" : 64, 
"type": "string" 


"nh: { 
"description": "Friendly name of the resource", 
"maxLength": 64, 

"type": "string" 


"e:q 
"description": "Region", 
"naxLength": 64, 

"type": "string" 
) 
"nt": 
"description": "Resource Type", 
"items": ( 
"naxLength": 64, 
"type": "string" 
) 
"minItems": 1, 
"readOnly": true, 
"type": "array" 




















) 
h 
"required": [ 
"p 
l 
"type": "object" 
} 
) 
} 
2. 属性 定义 
属性 定义 如 表 10-9 所 示 。 
表 10-9 属性 定义 
属 性 名 属性 值 类 型 是 否 强制 描 述 
icon FAR 位 置 的 人 性 化 名 称 
di FAR 默认 语言 
c FAR 货币 
ui 数组 资源 类 型 
id FAR 指定 资源 的 ID 

















198 «(|| OCF 技 术 原理 及 物 联网 程序 开发 指南 



































续 表 
mt 名 属性 值 类 型 是 否 强制 m x 

in 数组 林地 名 称 

" ETT 是 资源 的 友好 名 称 

"m 数组 位 置信 息 

ER [T3 

if 数组 资源 支持 的 接口 集合 

3. CRUDN 行为 

CRUDN 行为 如 表 10-10 所 示 。 

表 10-10 CRUDN 行为 
资源 | em | 检索 | 更 新 | mm | 通知 








/example/DeviceConfigurationResURI get post 


10.6 设备 


每 个 服务 器 端 托 管 的 已 知 资源 ,允许 发 现 逻 辑 设 备 特定 信息 .检索 设备 信息 。URI 示例 为 /oic/d”， 
资源 类 型 为 *oic. wk. d". 
1. Swagger 2. 0 定义 


{ 
"swagger": "2.0", 
"info": { 
"title": "Device", 
"version": "vi - 20160622", 
"license": { 
"name": "copyright 2016 - 2017 Open Connectivity Foundation, Inc. All rights reserved. ", 

"x - description": "Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met: Vn 1. Redistributions of source code must retain 
the above copyright notice, this list of conditions and the following disclaimer. Vn 2. Redistributions in 
binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer 
in the documentation and/or other materials provided with the distribution. \n\n THIS SOFTWARE IS PROVIDED BY 
THE Open Connectivity Foundation, INC. \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES OF 
NON — INFRINGEMENT, ARE DISCLAIMED. Vn IN NO EVENT SHALL THE Open Connectivity Foundation, INC. OR 
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 

} 
Lh 
"schemes": ["http"], 
"consumes": ["application/json"], 
"produces": ["application/json"], 
"paths": { 
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"/oic/d" : { 
"get": { 
"description": "Known resource that is hosted by every Server. \nAllows for logical device specific 
information to be discovered. \nRetrieve the information about the Device\n", 
"parameters": [ 
(" $ ref": "+ /parameters/interface"} 





1, 
"responses": { 
"200": { 
"description" : "", 
"x — example”: 
{ 
"n": "Device 1", 
"rt": — ["oic.wk.d"], 
"di^: "54919CA5 — 4101 — 4AE4 — 595B - 353C51AA983C", 
“larr "ocf.1.0.0", 
"dmv": "ocf.res.1.0.0, ocf.sh.1.0.0", 
"piid": "6FOAAC04 — 2BBO — 468D — B57C — 16570A26AE48" 
} 
, 
"schema": ( " $ ref": " & /definitions/Device" } 
) 
) 


Lh 
"parameters": ( 
"interface" : { 
"in" : "query", 
"name" : "if", 





"type" : "string", 
"enun" "oic. if.r", "oic. if. baseline" ] 
} 
Lh 
"definitions": ( 
"Device" : 
{ 
"properties": ( 
"di": 


"description": "Unique identifier for device (UUID)", 8499 
"pattern": "^[a- fA- F0 - 9] (8) - [a- £A- F0 - 9](4) - [a- fA- F0 - 9](4) - [a- fA- FO - 9](4) 
-[a-fA-F0- 9](12] $", 
"readOnly": true, 
"type": "string" 
)h 
"dmn": ( 
"description": "Manufacturer Name.", 
"items": { 
"properties": { 
"language": { 
"description": "An RFC 5646 language tag.", 
"pattern": "[A-Za- z](1,8)( -[A- Za- zo- 9](1,8)) * $", 
"readOnly": true, 
"type": "string" 








200 «(|| OCF 技 术 原理 及 物 联网 程序 开发 指南 


Lh 

"value": ( 
"description": "Manufacturer name in the indicated language.", 
"naxLength" : 64, 


"readOnly": true, 
"type": "string" 
) 
Lh 
"type": "object" 
Lh 
"ninItens": 1, 
"readOnly": true, 
"type": "array" 


"dmno": ( 
"description": "Model number as designated by manufacturer. ", 
"naxLength": 64, 
"readOnly": true, 
"type": "string" 
Lh 
"dmv": ( 
"description": "Spec versions of the Resource and Device Specifications to which this device 
data model is implemented", 
"naxLength": 256, 
"readOnly": true, 
"type": "string" 
} 


[1 f 
"description": "The version of the OIC Server", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 
Lh 
"ied 
"description": "Instance ID of this specific resource", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 


Lh 

"a£": ( 
"description": "The interface set supported by this resource", 
"items": { 


"enum": [ 

"oic. if. baseline", 

"oic. if.11", 

"oic.if.b", 

"oic. if.lb", 
oic.if.rw", 
oic.if.r", 
oic. if.a", 
oic. if. s" 


: "string" 


第 10 章 Swagger 定义 核心 资源 类 型 || 有 > 201 


"minItens": 1, 
"readOnly": true, 
atyp": "array" 


"rf 
"description": "Localized Description.", 
"items": ( 
"properties": ( 
"language" : ( 
"description": "An RFC 5646 language tag.", 
"pattern": "[A-Za- z](1,8)( - [A- Za- z0-9](1,8)) * $", 
"readOnly": true, 
"type": "string" 
Lh 
"value": ( 
"description": "Device description in the indicated language. ", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 


b 

"ninItens": 1, 
"readonly": true, 
"type" : "array" 


"description": "Friendly name of the resource", 
"maxLength": 64, 

"readOnly": true, 

"type": "string" 


"piid": ( 
"description": "Protocol independent unique identifier for device (UUID) that is immutable.", 
"pattern": "^[a- fA- F0 - 9](8) - [a- fA- F0 - 9](4) - [a- fA- F0 9](4) - [a- fA- FO - 9](4) 
-[a- fA- FO- 9](12] $", 
"readOnly": true, 
"type": "string" 


"ee" T 
"description": "Resource Type", 
"items": ( 
"naxLength": 64, 
"type": "string" 
B 
"minItems": 1, 
"readOnly": true, 
"type": "array" 
B 
"a": f 
"description": "Software version. ", 
"maxLength" : 64 
"readOnly": true, 
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"type": "string" 
} 
Lh 
"required": [ 
"n", 
"di", 
"icv", 
"dmv", 
"piid" 
L 
"type": "object" 


) 
} 










































































2. 属性 定义 
属性 定义 如 表 10-11 所 示 。 
表 10-11 属性 定义 
属 性 名 属性 值 类 型 访问 模式 | 是 否 强制 描 述 
id 数组 只 读 指定 资源 的 ID 示例 
piid 多 类 型 只 读 是 不 可 变 的 独立 于 协议 的 设备 唯一 标识 符 (UUID) 
di 多 类 型 只 读 是 设备 唯一 标识 符 
dmno 字符 串 只 读 由 制造 商 设计 的 型 号 
sv 字符 串 只 读 软件 版 本 
dmn 数组 只 读 制造 商 名 称 
icv Tm 只 读 是 OCF 服务 器 端的 版 本 
dmv 字符 串 只 读 是 该 设备 数据 模型 实现 的 资源 和 规格 版 本 
if 数组 只 读 资源 支持 的 接口 集合 
ld 数组 只 读 本 地 描述 
rt 数组 只 读 资源 类 型 
n 字符 串 只 读 是 资源 的 友好 名 称 
3. CRUDN 行为 
CRUDN 行为 如 表 10-12 所 示 。 
310-12. CRUDN 行为 
3t 源 创建 检索 更 新 删除 通知 
/oic/d get 
10.7 维护 


设备 维护 所 用 的 资源 可 用 于 诊断 目的 。“fr" 参 数 (出 厂 重 置 ) 是 一 个 布尔 值 . 值 0 表示 无 操作 (默认 
值 ) , 值 1 表示 在 出 场 复位 后 。 开 始 出 厂 复位 之 后 ,此 值 应 更 改 回 默 认 值 。“rb” 参 数 ( 重 新 启动 ) 也 是 一 
个 布尔 值 , 值 0 表示 无 操作 (默认 值 ), 值 1 表示 重新 启动 .然后 此 值 应 更 改 回 默认 值 。“ssc” 参 数 (开始 
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统计 集合 ) 是 一 个 布尔 值 , 值 0 表示 无 统计 信息 收集 , 值 1 表示 开始 收集 统计 信息 。URI 示例 为 
" /oic/ mnt" ,资源 类 型 为 “oic. wk. mnt”. 
1. Swagger 2. 0 定义 


t 

"swagger": "2.0", 
info": { 
"title": "Maintenance", 
"version": "vl 20160622", 
"license": ( 

"name": "copyright 2016 — 2017 Open Connectivity Foundation, Inc. All rights reserved.", 

"x - description": "Redistribution and use in source and binary forms, with or without 
modification, are permitted provided that the following conditions are met:\n 1. Redistributions of source 
code nust retain the above copyright notice, this list of conditions and the following disclaimer. Vn 2. 
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the 
following disclaimer in the documentation and/or other materials provided with the distribution. \n\n THIS 
SOFTWARE IS PROVIDED BY THE Open Connectivity Foundation, INC. V"AS ISV" AND ANY EXPRESS OR IMPLIED 
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE OR WARRANTIES OF NON — INFRINGEMENT, ARE DISCLAIMED. Vn IN NO EVENT SHALL THE Open 
Connectivity Foundation, INC. OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) Nn HOWEVER CAUSED AND ON ANY THEORY OF 
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY 
WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 

) 

) 

"schemes": ["http"], 

"consumes": ["application/json"], 

"produces": ["application/json"], 

"paths": ( 

"/oic/mnt" : { 
"get": { 

"description": "The resource through which a Device is maintained and can be used for diagnostic 
purposes. \nfr (Factory Reset) is a boolean. Vn The value 0 means No action (Default), the value 1 means Start 
Factory Reset\nAfter factory reset, this value shall be changed back to the default value\nrb (Reboot) is a 
boolean. \n The value 0 means No action (Default), the value 1 means Start Reboot \nAfter Reboot, this value 
shall be changed back to the default value\nRetrieve the maintenance action status", 

"parameters": [ 

(" $ ref": "+ /paraneters/interface - all"] 

l 

"responses" : ( 

"200": ( 
"description" : "", 
"x- example": 
t 
"rt": ["oic.wk.mnt"], 
"fr": false, 


) 


"schema": ( " $ ref": " # /definitions/MNT" ] 


rb": false 
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post": ( 
"description": "Set the maintenance action(s)\n", 
"parameters": [ 

(" $ ref": "# /parameters/ interface - rw"), 


{ 
"name": "body", 
"in": "body", 
"required": true, 
"schema": { " $ ref": "#/definitions/MNT" }, 
"x — example”: 
{ 


"fr": false, 


"rb": false 


} 
1, 
"responses": { 
"200": { 
"description" : "", 
"x- example": 
{ 
"fr": false, 
"rb": false 


) 


"schema": ( " $ ref": "#/definitions/MNT" ) 
) 
) 
) 
) 
n 
"parameters": { 
"interface- rw" : { 
"in" : "query", 
"name" : "if", 
"type" : "string", 
" 
Lh 
"interface- all" : { 


"in" 


enum" : ["oic. if. rw", "oic. if. baseline" ] 


: "query", 
"name" : "if", 
"type" : "string", 
"enun" : ["oic.if.rw", "oic.if.r", "oic. if. baseline"] 

} 
) 


"definitions": ( 


" 
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}, 
{ 
"required": [ 
"rb" 
] 
) 
L 
"properties": { 
"ge". 


"description": "Factory Reset", 
"type": "boolean" 
, 
"id": { 
"description": "Instance ID of this specific resource", 
"maxLength" : 64, 
"readOnly": true, 
"type": "string" 
Lh 
"a£": ( 
"description": "The interface set supported by this resource", 
"itens": ( 
" "L 
"oic. if. baseline", 
"oic. if.11", 
"oic. if.b", 
"oic. if. lb", 
oic.if.rw", 
oic.if.r", 
oic.if.a", 
oic.if.s" 
1, 
"type 
}, 
"minItems": 1, 
"readOnly": true, 
"type": "array" 


: "string" 


Pats d 
"description": "Friendly name of the resource", 
"naxLength": 64 
"readOnly": true, 
"type": "string" 
}, 
“ohh: { 
"description": "Reboot Action", 
"type": "boolean" 
}, 
"uet ef 
"description": "Resource Type", 
"items": { 
"maxLength": 64, 
"type": "string" 
) 


"minItems": 1, 
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"readOnly": true, 


) 
) 
"type": "object" 
) 


} 


2. 属性 定义 
属性 定义 如 表 10-13 所 示 。 
表 10-13 属性 定义 



































属 性 名 属性 值 类 型 访问 模式 是 否 强制 描 述 
id 数组 只 读 本 地 描述 
fr 布尔 只 读 是 工厂 重 置 
rb 布尔 只 读 重新 启动 操作 
rt 数组 只 读 资源 类 型 
n 字符 串 只 读 是 资源 的 友好 名 称 
if 数组 只 读 资源 支持 的 接口 集合 
3. CRUDN 行为 


CRUDN 行为 如 表 10-14 所 示 o 
表 10-14 CRUDN 行为 
资 03 创建 检索 更 新 删除 通知 


/oic/ mnt get post 





10.8 平台 


已 知 资源 ,定义 托管 服务 器 端的 平台 ,允许 发 现 特定 于 平台 的 信息 ,检索 平台 有 关 信 息 。URI 示例 
为 /oic/p”, 该 资源 类 型 被 定义 为 *oic. wk. p". 
1. Swagger 2.0 定义 


{ 
"swagger": "2.0", 
"info": { 

"title": "Platform", 

"version": "v1 — 20160622", 

"license": { 

"name": "copyright 2016 — 2017 Open Connectivity Foundation, Inc. All rights reserved.", 

"x — description": "Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met:\n 1. Redistributions of source code must retain 
the above copyright notice, this list of conditions and the following disclaimer. Vn 2. Redistributions in 
binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer 
in the documentation and/or other materials provided with the distribution. \n\n THIS SOFTWARE IS PROVIDED BY 
THE Open Connectivity Foundation, INC. \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
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LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES OF 
NON — INFRINGEMENT, ARE DISCLAIMED. V n IN NO EVENT SHALL THE Open Connectivity Foundation, INC. OR 
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 
) 
}, 
"schemes": ["http"], 
"consumes": ["application/json"], 
"produces": ["application/json"], 
"paths": { 
"Joic/p" : { 
"get": { 
"description": "Known resource that is defines the platform on which an Server is hosted. \nAllows 
for platform specific information to be discovered. \nRetrieve the information about the Platform\n", 
"parameters": [ 
(" $ ref": "+ /paraneters/interface") 
1, 
"responses": { 
"200": { 
"description" : "", 
"x- example": 
{ 
"pi": "54919CA5 — 4101 - 4AE4 — 595B — 353C51AA983C", 
"rt": ["oic. wk. p"], 
"mnmn": "Acme, Inc" 
} 


"schema": ( " $ ref": "+#/definitions/Platforn" } 
} 


} 
) 
"parameters": ( 

"interface" : { 

"in" : "query", 

"if", 
string", 
["oic. if.r", "oic. if. baseline" ] 





)h 
"definitions": { 
"Platform" : 
{ 
"properties": { 
"id": { 
"description": "Instance ID of this specific resource", 
"maxLength": 64, 
"readonly": true, 
"type": "string” 
)h 
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"igi 
"description": "The interface set supported by this resource", 
"itens": ( 
"enun": [ 
"oic. if. baseline", 


"oic. if.11", 
"oic. if.b", 
"oic. if. 1b", 
oic. if. rw", 
oic. if. r", 
oic.if.a", 
oic. if. s" 


: "string" 
}, 

"ninItens": 1, 
"readOnly" : true, 
"type": "array" 


"nndt" : ( 
"description": "Manufacturing Date. ", 
"pattern": "*([0-9]{4}) - (100-2]]10[1-9]) - (3[0- 1]]2[0- 9]]1[0-9]]0[1-9]) $", 
"readonly": true, 
"type": "string" 


Lh 

"mnfv": { 
"description": "Manufacturer's firmware version", 
"naxLength": 64, 


"readOnly": true, 
"type": "string" 


"nnhw" : ( 
"description": "Platform Hardware Version", 
"maxLength" : 64, 
"readOnly": true, 
"type": "string" 
Lh 
"mnml": ( 
"description": "Manufacturer's URL", 
"format": "uri", 
"maxLength": 256, 
"readOnly": true, 
"type": "string" 
"anan": ( 
"description": "Manufacturer Name", 
"maxLength": 64 
"readOnly": true, 
"type": "string" 


"mnmo" : ( 
"description": "Model number as designated by manufacturer", 
"maxLength": 64 
"readOnly" : true, 
"type": "string" 
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"maxLength" : 64, 


"description": "Platform Version", 
"naxLength": 64, 
"readOnly": true, 
"type": "string" 
Lh 
"nnsl": { 
"description": "Manufacturer's Support Information URL", 
"format": "uri", 
"naxLength" : 256, 
"readonly": true, 
"type": "string" 


"description": "Friendly name of the resource", 
"naxLength": 64, 
"readOnly": true, 
"type": "string" 


"description": "Platform Identifier as a UUID", 
"pattern": "^[a- fA- F0 - 9](8) - [a- fA- FO - 9](4) - [a- fA- F0 - 9](4) - [a- fA- FO - 9](4) 
-[a-fa- F0-9](12) $", 
"readonly": true, 
"type": "string" 
) 
Prt? sf 
"description": "Resource Type", 
"items": { 
"maxLength" : 64, 
"type": "string" 
) 
"ninItens": 1, 
"readOnly": true, 
"type": "array" 


"st": ( 
"description": "Reference time for the device as defined in ISO 8601, where concatenation of 
‘date’ and 'time' with the "T'as a delimiter between ‘date’ and 'time'.", 
"format": "date- time", 
"readonly": true, 
"type": "string" 


"vid": ( 
"description": "Manufacturer's defined string for the platform. The string is freeform and up 
to the manufacturer on what text to populate it", 
"naxLength": 64, 
"readOnly": true, 
"type": "string" 
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2. 属性 定义 
属性 定义 如 表 10-15 所 示 。 
表 10-15 属性 定义 

属 性 名 属性 值 类 型 访问 模式 是 否 强制 d 述 
pi 字符 串 只 读 是 台 标 识 符 作 为 UUID 
mnmn 字符 串 Ri& 是 厂商 名 称 

mnml 字符 串 只 读 厂商 的 URL 

mnmo 字符 串 只 读 由 厂商 指定 的 型 号 

mndt 字符 串 只 读 制造 日 期 

mnpv 字符 串 只 读 平台 版 本 

mnos 字符 串 读 写 只 读 ,平台 驻 留 操作 系统 版 本 
mnhw 字符 串 读 写 只 读 , 平 台 硬 件 版 本 

mnfv 字符 串 Rik 制造 商 的 固件 版 本 

mnsl 字符 串 Rik 制造 商 的 支持 信息 URL. 

st 字符 串 Rik 设备 的 参考 时 间 

制造 商 为 平台 定义 的 字符 串 。 字 符 串 是 自由 

iin TRS aR 格式 的 ,并 且 根 据 制造 商 填充 文本 
n 字符 串 只 读 资源 的 友好 名 称 

if 数组 只 读 资源 支持 的 接口 集合 

rt 数组 只 读 资源 类 型 

id 字符 串 只 读 指定 资源 的 ID 示例 

3. CRUDN 行为 


CRUDN 行为 如 表 10-16 所 示 。 
表 10-16 CRUDN 行为 





资 源 创建 检索 更 新 删除 通知 





/oic/p get 




















10.9 ping 


客户 端 保持 其 与 服务 器 端 连接 的 资源 处 于 活动 状态 ,检索 ping 的 信息 。URI 示 例 为 “/oic/ping”， 
资源 类 型 为 “oic. wk. ping”. 
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1. Swagger 2. 0 定义 


t 
"swagger": "2.0", 
"info": { 
"title": "Ping", 
"version": "vl 20160622", 
"license": ( 

"name": "copyright 2016 - 2017 Open Connectivity Foundation, Inc. All rights reserved.", 

"x - description": "Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met:\n 1. Redistributions of source code must retain 
the above copyright notice, this list of conditions and the following disclaimer. Vn 2. Redistributions in 
binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer 
in the documentation and/or other materials provided with the distribution. \n\n THIS SOFTWARE IS PROVIDED BY 
THE Open Connectivity Foundation, INC. \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES OF 
NON - INFRINGEMENT, ARE DISCLAIMED. Vn IN NO EVENT SHALL THE Open Connectivity Foundation, INC. OR 
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 

) 

}, 

"schemes": ["http"], 

"consumes": ["application/json"], 

"produces" : ["application/json"], 

"paths": ( 

"/oic/ping" : { 
"get": { 
"description": "The resource using which an Client keeps its Connection with an Server active. \ 
nRetrieve the ping information", 
"parameters": [ 
(" $ ref": "+ /paraneters/interface") 
L 
"responses": { 
"200": { 
"description" : "", 
"x— example": 
t 
"rt": ["oic. wk. ping"], 
"n": "Ping Information", 
"in": 16 





post": { 

"description": 

"parameters": [ 
(" $ ref": " # /paraneters/interface"]), 
{ 





Update or reset the alive interval", 
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"name": "body", 
"in": "body", 
"required": true, 


"schema": ( " $ ref": " & /definitions/PING" }, 


"x - example": 


: "Successfully updated & restarted alive interval timer.", 


"schema": ( " $ ref": " & /definitions/PING" } 


{ 
"in": 16 
} 
} 
l 
"responses": ( 
"203": ( 
"description" 
"x ~ example": 
{ 
"in": 16 
} 
) 
) 
) 
} 
h 


"parameters": { 
"interface" : { 





Lh 
"definitions": { 
"PING" : 
{ 
"properties": ( 
"ade 


"description": "Instance ID of this specific resource", 


"maxLength": 64, 
"readOnly": true, 
"type": "string" 
) 
fig. d 


"description": "The interface set supported by this resource", 


"items": ( 
" "ut 


"oic. if. baseline", 


"oic. if.11", 
"oic.if.b", 
"oic. if.lb", 
oic.if.rw", 
oic.if.r", 
oic.if.a", 
oic. if. s" 
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L 
"type": "string" 
B 
"minItems": 1, 
"readonly": true, 
"type": "array" 
Lh 
"in": { 
"description": "Indicates the interval for which connection shall be kept alive", 
"readOnly": false, 
"type": "integer" 


"n: ( 
"description": "Friendly name of the resource", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 
Lh 
"re" 
"description": "Resource Type", 
"items": ( 
"maxLength": 64, 
E string" 
} 
"minItems": 1 
"readOnly": true, 
"type": "array" 


type": 


"type": "object" 




















) 

) 

} 

2. 属性 定义 

属性 定义 如 表 10-17 所 示 。 

表 10-17 属性 定义 
属 性 名 属性 值 类 型 访问 模式 是 否 强制 do xk 

in 整 型 读 写 是 说 明 连接 应 该 保持 激活 的 间隔 
n 字符 串 只 读 资源 的 友好 名 称 
if 数组 只 读 资源 支持 的 接口 集合 
rt 数组 只 读 资源 类 型 
id 字符 串 RE 指定 资源 的 ID 示例 

















3. CRUDN 行为 
CRUDN 行为 如 表 10-18 所 示 。 


214 || OCF 技 术 原 








及 物 联 网 程序 开发 指南 


表 10-18 CRUDN 行为 
资 源 创建 检索 更 新 删除 通知 


/oic/ping get post 


























10.10 资源 目录 资源 


任何 可 以 作为 资源 目录 的 设备 公开 资源 : 1) 使 用 GET 请 求 提供 选择 标准 (例如 整数 ); 2) 使 用 
POST 请 求 在 “/oic/res” 中 发 布 或 更 新 链接 ; 3) 使 用 DELETE 请 求 删 除 “/oic/res” 中 的 链接 。 获 取 资 源 
目录 属性 以 进行 选择 。URI 示例 为 /oic/rd”, 资 源 类 型 为 oic. wk. rd”, 

1. Swagger 2. 0 定义 


{ 
"swagger": "2.0", 
"info": ( 
"title": "Resource directory resource", 
"version": "vl — 20160622", 
"license": ( 

"name": "copyright 2016 - 2017 Open Connectivity Foundation, Inc. All rights reserved.", 

"x- description": "Redistribution and use in source and binary forms, with or withoutmodification, 
are permitted provided that the following conditions are met:\n 1. Redistributions of source code must retain 
the above copyright notice, this list of conditions and the following disclaimer. Vn 2. Redistributions in 
binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer 
in the documentation and/or other materials provided with the distribution. \n\n THIS SOFTWARE IS PROVIDED BY 
THE Open Connectivity Foundation, INC. \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES OF 
NON — INFRINGEMENT, ARE DISCLAIMED. Vn IN NO EVENT SHALL THE Open Connectivity Foundation, INC. OR 
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 

} 
) 
"schemes": ["http"], 
"consumes" : ["application/json"], 
"produces": ["application/json"], 
"paths": ( 
"/oic/rd" : ( 
"get": { 
"description": "Resource to be exposed by any Device that can act as a Resource Directory. \nl) 
Provides selector criteria (e.g., integer) with GET request Vn2) Publish or Update a Link in /oic/res with 


POST request n3) Delete a Link in /oic/res with DELETE request\nGet the attributes of the Resource Directory 
for selection purposes. n", 


"parameters": [ 
(" $ ref": "+ /parameters/rdget interface" } 
L 
"responses" : { 
"200": { 
"description" : "Respond with the selector criteria — either the set of attributes or the 
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bias factor\n", 
"x - example”: 
t 
"rt": ["oic.wk. rd"], 
"if": ["oic. if. baseline"], 
"sel": 50 
H 
"schema": ( " $ ref": " & /definitions/rdSelection" } 
) 
} 
h 
"post": ( 

"description": "Publish the resource information for the first time or Update the existing one in / 
oic/res. \nAppropriates parts of the information, i.e., Links of the published Resources will be discovered 
through /oic/res. \n1) When a Device first publishes a Link, the request payload to RD may include the Links 
without V'insV" Parameter. \n2) Upon granting the request, the RD assigns a unique instance value identifying 
the Link among all the Links it advertises\n and sends back the instance value in V" insV" Parameter in the 
Link to the publishing Device. n3) When later the publishing Device updates the existing Link, i.e., changing 
its Endpoint information, Vn the request payload to RD needs to include the instance value in V" ins V" 
Parameter to identify the Link to update. Wn", 

"parameters": [ 

(" $ ref": "+ /paraneters/rdpostinterface"], 
t 
"nane": "body", 
"in": "body", 
"required": true, 
"schema": ( " $ ref": " & /definitions/rdPublish" }, 
"x — example": 
{ 
"di": "e61c3e6b - 9c54 — 4b81 — 8ce5 — £9039c1d04d9", 
"links": [ 
$ 


anchor": "ocf://e61c3e6b — 9c54 — 4b81 — 8ce5 - f9039c1d04d9", 
"href": "/myLightSwitch", 

["oic. r. switch. binary" ], 

["oic. if.a", "oic. if. baseline"], 

{"bm": 3}, 





{"ep": "coaps://[2001 :db8 1d6]:1111", "pri": 2}, 
: "coaps: //[2001 :db8:a: :b1d6] :1122"], 
{"ep": "coaps + tcp://[2001:db8:a::123]:2222", "pri": 3} 





"anchor": "ocf ://e61c3e6b — 9c54 - 4b81 - 8ce5 — £9039c1d04d9" , 
"href":  "/nmyLightBrightness", 


"rt": —— ["oic.r.brightness"], 

"ie": ["oic. if.a", "oic. if. baseline"], 
"p's {"bm": 3}, 

"eps": [ 


{"ep": "coaps://[ [2001 :db8:a: :123]:2222"} 
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1, 
"ttl": 600 


} 
L 
"responses": { 
"200": { 
"description" : "Respond with the same schema as publish but, when a Link is first published, 
\nwith the additional \"ins\" Parameter in the Link. \nThis value is used by the receiver to manage that OCF 
Link instance. \n", 
"x— example": 





{ 
"di": "e61c3e6b — 9c54 — 4b81 - 8ce5 - £9039c1d04d9", 
"Links": [ 
{ 
"anchor": "ocf://e61c3e6b - 9c54 — 4b81 - 8ce5 ~ £9039c1d04d9", 
"href":  "/myLightSwitch", 
"rt": ["oic. r. switch. binary" ], 
NIE" ["oic.if.a", "oic. if. baseline” ], 
"p": {"bm": 3}, 
"coaps: //[2001 :db8 111", "pri": 2}, 
"coaps: //[2001:db8:a:: 122"), 
p": "coaps + tcp: //[2001:db8:a::123]:2222", "pri": 3} 
"ins": "11235" 
n 
t 
"anchor": "ocf : //e61c3e6b — 9c54 — 4b81 - 8ce5 — £9039c1d04d9" , 
"href": —"/myLightBrightness", 
"xen ["oic. r. brightness" ], 
wit": ["oic.if.a", "oic. if. baseline" ], 
"p": {"bm": 3}, 
"eps": [ 
{"ep": "coaps://[2001:db8:a: :123]:2222"} 
l 
"ins": "112358" 
} 
l 
"ttl": 600 
} 
"schema": { " $ ref": "#/definitions/rdPublish" } 
} 
} 
h 
"delete": { 


"description" :"Delete a particular OIC Link - the link may be a simple link or a link in a tagged set. Vn", 
"parameters": [ 
(" $ ref": "# /paraneters/rddelete - di"), 
(" $ ref": "+ /paraneters/rddelete - ins"} 
L 
"responses" : { 
"200": { 


"description" : "The delete succeeded", 
"x— example": 


{} 


} 
} 
} 
L 
"parameters": ( 
"rddelete - di" : { 
"in" : "query", 
"name" : "di", 
"type" : "string", 
"description" : "description" 
) 


"rddelete- ins" : ( 





"type" string", 
"description" : "description" 
B 
"rdgetinterface" : ( 
"jn" : "query", 
"name" : "if", 
"string", 
"oic. if. baseline" ], 
"description" : "enumdescription" 
Lh 
"rdpostinterface" : ( 
"in" : "query", 











"oic. wk. rdpub" J, 
"description" : "enumdescription" 





) 
}, 
"definitions": { 
"rdSelection" : 
{ 
"oneOf" : [ 
{ 
"properties": { 
"sel": { 
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"description": "A bias factor calculated by the Resource directory - the value is in the 
range of 0 to 100 — 0 implies that RD is not to be selected. Client chooses RD with highest bias factor or 
randomly between RDs that have same bias factor", 

"maximum": 100, 
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) 
{ 
"properties": { 
"id": { 
"description": "Instance ID of this specific resource", 
"naxLength" : 64, 


"readOnly": true, 
"type": "string" 








} 
"if": { 
"description": "The interface set supported by this resource", 
"items": { 
[ 
ic. if. baseline", 
ic. if.11", 
zif., 
ic.if.lb", 
oic. if. rw", 
"oic. if.r", 
"oic. if.a", 
oic.if.s 
"type": "string" 


}, 
"ninItens": 1, 
"readOnly": true, 
"type": "array" 
) 
"a": { 
"description": "Friendly name of the resource", 
"naxLength": 64, 
"readonly": true, 
"type": "string" 
) 
rti 
"description": "Resource Type", 
"items": { 
"maxLength" : 64, 
"type": "string" 


ninlItems": 1, 
"readonly": true, 
"type": "array" 
Lh 
"sel": { 
"description": "Selection criteria that a device wanting to publish to any RD can use to 
choose this Resource Directory over others that are discovered", 
"properties": ( 
"bw": { 
"description": "Qualitative bandwidth of the connection", 
"enun": [ 
"high", 
"low", 
"lossy" 
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"description": "A hint about the networking connectivity of the RD. *wrd* if wired 
connected and * wrls* if wireless connected. ", 
"enum": [ 


"load": ( 
"description": "Current load capacity of the RD. Expressed as a load factor 3- tuple 


(upto two decimal points each). Load factor is based on request processed in a 1 minute, 5 minute window and 15 
minute window", 


"items": ( 
"type": "number" 
Lh 
"maxItems" : 3, 
"minItems": 3, 
"type": "array" 
) 
ves 
"description": "Memory factor - Ratio of available memory to total memory expressed 
as a percentage", 


"description": "A hint about how the RD is powered. If AC then this is stronger than 
battery powered. If source is reliable (safe) then appropriate mechanism for managing power failure exists", 


"enum": [ 
"ac", 
"batt", 
"safe" 
l 
"type": "string" 
) 
Lh 
"type": "object" 
) 
}, 
"required": [ 
"sel" 
] 
) 
l 
"type": "object" 
) 
"rdPublish" : 
{ 


"description": "Publishes resources as OIC Links into the resource directory", 
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"properties": ( 

"di": ( 
"description": "A unique identifier for the publishing Device, i.e., its device ID", 
"pattern": "^[a- fA- F0 — 9](8) - [a- £A F0 - 9](4) - [a- fA- F0 — 9](4) - [a- fA- F0 - 9](4] 

-[a-fa-F0-9](12) $", 

"type" : "string 

b 

"id": { 
"description": "Instance ID of this specific resource", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 


"En T 
"description": "The interface set supported by this resource", 
"items": ( 
" "Sf 
"oic. if. baseline", 
"oic. if.11", 


minItems": 1, 
"readOnly": true, 
"type": "array" 
} 
"links": ( 
"description": "A set (array) of simple or individual OIC Links. In addition to properties 
required for an OIC Link, the identifier for that link in this set is also required", 
"items": { 
"properties": { 
"anchor": { 
"description": "This is used to override the context URI e.g. override the URI of the 
containing collection", 
"format": "uri", 
"maxLength" : 256, 
"type": "string" 
Lh 
"di^: { 
"description": "Unique identifier for device (UUID)", 
"pattern": "[a- fA- F0 - 9](8) - [a- fA- F0 - 9](4) - [a- fA-FO-9]{4} - [a- fA- 
F0-9](4)-[a- fA- F0-9](12) $", 
"type": "string" 


}, 
"eps": { 
"description": "the Endpoint information of the target Resource", 
"items": ( 


"properties": ( 
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"ep": ( 
"description": "URI with Transport Protocol Suites + Endpoint Locator as specified", 
"type": "string" 

}, 

"pri": { 

"description": "The priority among multiple Endpoints as specified ", 
"minimun": 1, 
"type": "integer" 


} 
B 
"type": "object" 
) 
"type": "array" 
Lh 
"href": ( 


"description": "This is the target URI, it can be specified as a Relative Reference or 
fully- qualified URI. Relative Reference should be used along with the di parameter to make it unique.", 
"format": "uri", 
"naxLength": 256, 
"type": "string" 
}, 
"ipt. 
"description": "The interface set supported by this resource", 
"items": ( 
"enun": [ 
oic.if.baseline", 9 
"oic. if. 11", 











区 
sole, .a 


E 





"oic.i 
7 
"type": "string" 
Lb 
"ninItens": 1, 
"type": "array" 


"description": "The instance identifier for this web link in an array of web links — 
used in collections", 
"oneOf": [ 
t 
"description": "An ordinal number that is not repeated — must be unique in the 
collection context", 
"type": "integer" 
1,9 
{ 
"description": "Any unique string including a URI", 
"format": "uri", 
"maxLength" : 256, 
"type": "string" 
h 
t 
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"description": "Unique identifier (UUID)", 

"pattern": "^[a- fA - F0 - 9] (8) - [a- £A- F0 - 9](4) - [a- fA- FO- 9](4) - [a- fA 
-F0-9](4)-[a- fA-FO-9]{12}$", 

"type": "string" 


"description": "Specifies the framework policies on the Resource referenced by the 
target URI", 


"properties": ( 
"ba": ( 
"description": "Specifies the framework policies on the Resource referenced by the 
target URI for e.g. observable and discoverable", 
"type": "integer" 


1, 
"type" : "object" 


Weel? sf 


"description": "The relation of the target URI referenced by the link to the context 


"oneOf": [ 
{ 
"default": [ 
"hosts" 


) 
"minItems": 1, 
"type": "array" 

n 

{ 
"default": "hosts", 
"naxLength" : 64, 

": "string" 


Lh 
"rt": { 
"description": "Resource Type", 
"items": ( 
"maxLength" : 6 
"type": "string" 
, 
"ninItems": 1, 
"type": "array" 
}, 
"title": { 
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"description": "A title for the link relation. Can be used by the UI to provide a 
context", 
"maxLength" : 64, 
"type": "string" 
Lh 
"type": ( 
"default": "application/cbor", 
"description": "A hint at the representation of the resource referenced by the target 
URI. This represents the media types that are used for both accepting and emitting", 
itens": ( 
"maxLength" : 64, 
: "string" 


"ninItens": 1, 
"type": "array" 





"description": "Friendly name of the resource", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 


"uM 


"items": { 


minItems": 1, 


Lh 
"ttl": ( 
"description": "Time to indicate a RD, how long to keep this published item. After this time 
(in seconds) elapses, the RD invalidates the links. To keep link alive the publishing device 
updates the ttl using the update schema", 
"type": "integer" 
) 
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2. 属性 定义 
属性 定义 如 表 10-19 Bron 。 
X1019 属性 定义 
属 性 名 属性 值 类 型 访问 模式 | 是 否 强制 d o xk 
n 字符 串 Ri 资源 的 友好 名 称 
if 数组 只 读 资源 支持 的 接口 集合 
rt 数组 只 读 资源 类 型 
id 字符 串 只 读 指定 资源 的 ID 示例 
指示 RD 的 时 间 , 保 留 已 发 布 资 源 的 时 间 。 经 过 这 段 
ttl 整 型 时 间 ( 秒 ) 后 ,RD 会 使 链接 无 效 。 为 了 使 链接 保持 活 
动 ,发 布设 备 使 用 更 新 模式 更 新 tt] 
数组 一 组 简单 或 单独 的 OCF 链接 (数组 )。 除 了 OCF 链 路 
所 需 的 属性 之 外 ,还 需要 该 集合 中 链接 的 标识 符 
di 字符 串 设备 唯一 标识 符 
ae ue 是 一 种 选择 标准 ,关于 设备 所 要 发 布 的 RD 上 ,以 此 选择 
可 发 现 的 资源 目录 
3. CRUDN 行为 


CRUDN 行为 如 表 10-20 所 示 。 
# 10-20 CRUDN 行为 


资 dg 创建 检索 更 新 删除 通知 


/oic/ rd get post delete 





10.11 可 发 现 资源 


检索 可 发 现 资源 集合 。URI 示例 为 “/oic/res”, 资 源 类 型 为 “oic. wk. res". 
1. Swagger 2.0 定义 


{ 
"swagger": "2.0", 
"info": { 
"title": "Discoverable Resources Baseline Interface", 
"version": "v1 — 20160622", 
"license": { 

"name": "copyright 2016 — 2017 Open Connectivity Foundation, Inc. All rights reserved. ", 

"x — description": "Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met:\n 1. Redistributions of source code must retain 
the above copyright notice, this list of conditions and the following disclaimer. Vn 2. Redistributions in 
binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer 
in the documentation and/orother materials provided with the distribution. \n\n THIS SOFTWARE IS PROVIDED BY 
THE Open Connectivity Foundation, INC. \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES OF 
NON — INFRINGEMENT, ARE DISCLAIMED. Vn IN NO EVENT SHALL THE Open Connectivity Foundation, INC. OR 
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CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 


} 
}, 


"schemes": [" 


http"), 


"consumes": ["application/json"], 
"produces": ["application/json"], 


"paths": { 


"/oic- res - BaselineInterfaceURI" : { 


"get": { 


"description": "Baseline representation of /oic/res; list of discoverable resources\nRetrieve the 
discoverable resource set, baseline interface\n", 
"parameters": [ 


(" $ ref": "+ /paraneters/interface — baseline" } 





"200": ( 


) 


"description" : "", 
"x- example": 
[ 
{ 


rt": ["oic. wk. res"], 


"if": ["oic. if. baseline", "oic. if.11" ], 


"links": 


"href": "/humidity", 

rt":  ["oic.r. humidity" ], 
: ["oic.if.s"], 

"p":  {"bm": 3}, 


"coaps://{ £80: :b1d6]:1111", "pri": 2}, 
"coaps://[ £80: :b1d6] :1122"), 


p": "coap + tcp://[ 2001 :db8:a: :123]:2222", "pri": 3) 





"href": "/temperature", 


"rt": ["oic.r. temperature" ], 
Mares. dE oic ifja");, 

"p":  {"bm": 3}, 

"eps": [ 


{"ep": "coaps://[ [2001 :db8:a: :123] :2222") 


"schema": ( " $ ref": "#/definitions/sbaseline" } 
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) 
) 
) 
"/oic - res - llInterfaceURI" : { 
"get": { 


"description": "Link list representation of /oic/res; list of discoverable 
resources\nRetrieve the discoverable resource set, link list interface\n", 
"parameters": [ 
(" $ ref": " # /parameters/interface - 11"} 





L 
"responses": { 
"200": { 
"description" : "", 
"x— example": 
[ 
{ 
"href": "/hunidity", 
"rt": — ["oic.r. hunidity"], 
"AE". (["oic.idE.s"], 
"p":  {"bm": 3), 
"eps": [ 
{"ep": "coaps://[fe80::b1d6]:1111", "pri": 2}, 
("ep" : "coaps://[£e80: :b1d6]:1122"}, 
{"ep": "coaps + tcp://[2001:db8:a::123]:2222", "pri": 3) 
] 
}, 
{ 
"href": "/tenperature", 
"oic. r. temperature" ], 
"oic. if.s"], 
{"bm": 3), 
[ 
" : "coaps://[[2001:db8:a: :123]:2222") 
} 
] 
"schema": { " $ ref": "+ /definitions/slinklist" } 
} 
} 
} 
} 
) 


"parameters": ( 
"interface- 11" : { 
: "query", 
gir, 
"type" : "string", 
"enun" : ["oic.if.11"] 
), 9867 
"interface - baseline" : 
"in" : "query", 
"name" : "if", 
"type" : "string", 
"enun" : ["oic. if.baseline"] 
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} 
}, 
"definitions": { 
"sbaseline" : 
t 
"properties": ( 
rigid 
"description": "The interface set supported by this resource", 
"items": ( 
"enun": [ 
"oic. if. baseline", 
"oic. if.11" 
l 
"type": "string" 
}, 
"minItems": 1, 
"readOnly": true, 
"type": "array" 


"items": { 
"properties": { 
"anchor": { 
"description": "This is used to override the context URI e.g. override the URI of the 
containing collection", 

"format": "uri", 

"naxLength" : 256, 

"type": "string" 

}, 
"di": { 
"description": "Unique identifier for device (UUID)", 
"pattern": "^[a- fA- F0 - 9](8) —[a-£A-FO-9]{4} - [a- f£A- F0 - 9](4) - [a- fA- 
F0-9](4) -[a- fA- FO-9]{12}$", 
"type": "string" 
Lh 
"eps": { 
"description": "the Endpoint information of the target Resource", 
"items": ( 
"properties": { 
"ep": { 

"description": "URI with Transport Protocol Suites + Endpoint Locator as specified", 
"format": "uri", 
x : "string" 


"description":"The priority among multiple Endpoints as specified ", 
"ninimum": 1, 
"type": "integer" 





228 «(|| OCF 技 术 原理 及 物 联网 程序 开发 指南 


"href": { 
"description": "This is the target URI, it can be specified as a Relative Reference or 
fully- qualified URI. Relative Reference should be used along with the di parameter to make it unique.", 
"format": "uri", 
"maxLength": 256, 
"type": "string" 
Lh 
"ie": { 
"description": "The interface set supported by this resource", 
"items": { 
"enun": [ 
"oic. if. baseline", 
"oic. if.11", 
A 
ic. if. rw", 


E 





oic.if.s" 


: "string" 


"minItems": 1, 
"type": "array" 
Lh 
"ins": ( 
"description": "The instance identifier for this web link in an array of web links — 
used in collections", 
"oneOf": [ 
{ 
"description": "An ordinal number that is not repeated — must be unique in the 
collection context", 
"type": "integer" 
Lh 
{ 
"description": "Any unique string including a URI", 
"format": "uri", 
"naxLength" : 256, 
"type": "string" 
Lh 
t 


"description": "Unique identifier (UUID)", 
"pattern": "^[a - fA- F0 - 9](8) - [a- fA— F0 - 9](4) - [a- fA- F0 - 9](4) - [a- fA 
-F0-9](4) - [a- fA- F0 - 9](12) $", 
"type": "string" 


"description": "Specifies the framework policies on the Resource referenced by the target 
URI", 
"properties": { 
"bu": { 
"description": "Specifies the framework policies on the Resource referenced by the 
target URI for e.g. observable and discoverable", 
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"type": "object" 
), 9991 
"rel": ( 

"description": "The relation of the target URI referenced by the link to the context URI", 

"oneOf": [ 

t 
"default": [ 
"hosts" 


items": ( 
"naxLength" : 64, 
"type": "string" 
) 
"ninItens": 1, 
"type": "array" 
L 
t 
"default": "hosts", 
"naxLength": 64, 
"type" : "string" 


Prem tcl 
"description": "Resource Type", 
"items": { 
"maxLength" : 64, 
"type": "string" 
Lh 
"ninItens": 1, 
"type": "array" 


"title": { 
"description": "A title for the link relation. Can be used by the UI to provide a context", 
"maxLength" : 64, 

": "string" 


"type": { 
"default": "application/cbor", 1 
"description": "A hint at the representation of the resource referenced by the target 
URI. This represents the media types that are used for both accepting and emitting", 
"items": ( 


"ninItens": 1, 


"type": "array' 
} 
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"type": "object" 
B 
"type": "array" 
Lh 


"description": "Supported messaging protocols", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 
Lh 
wW 
"description": "Human friendly name", 
"maxLength": 64, 
"readOnly": true, 
"type": "string" 
Lh 


"items": { 


"minItems": 1, 
"readOnly": true, 
"type": "array" 
) 
) 
"required" : [ 
"rt", 
"ig", 
"links" 
L 
"type": "object" 
} 


"slinklist" : 
{ 
"properties": { 
"anchor": { 
"description": "This is used to override the context URI e.g. override the URI of the containing 
collection", 

"format": "uri", 

"naxLength": 256, 

"type": "string" 


"di": ( 
"description": "Unique identifier for device (UUID)", 
"pattern": "^[a— fA- FO - 9](8) - [a- £A F0 - 9](4) - [a fA- FO - 9](4) - [a- fA- F0- 9]{4} 
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-[a-fA-F0-19](12] $ ", 1 
"type": "string" 





) 
"eps": ( 
"description": "the Endpoint information of the target Resource", 
"items": ( 
"properties": ( 
"ep": ( 
"description": "URI with Transport Protocol Suites * Endpoint Locator as specified ", 
"format": "uri", 
"type": "string" 
Lh 
"pri": ( 
"description": "The priority among multiple Endpoints as specified", 
"minimum": 1, 
"type": "integer" 
H 
Lh 
"type" : "object" 
}, 
"type": "array" 
b 
"href": ( 


"description": "This is the target URI, it can be specified as a Relative Reference or fully- 
qualified URI. Relative Reference should be used along with the di parameter to make it unique. ", 
"format": "uri", 
"maxLength" : 256, 
"type": "string" 
Lh 
FD. | 
"description": "The interface set supported by this resource", 
"items": ( 
"enum": [ 
"oic. if. baseline", 
"oic. if.11", 
"oic. if. b", 
oic. if. rw", 
oic. if. r", 
oic. if.a", 
oic.if.s" 


: "string" 


"ninItems": 1, 
"type": "array" 


) 
"ins": ( 
"description": "The instance identifier for this web link in an array of web links — used in 
collections", 
"oneOf" : [ 
t 
"description": "An ordinal number that is not repeated — must be unique in the collection 
context", 


"type": "integer" 
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Lh 
t 


"description": "Any unique string including a URI", 
"format": "uri", 
"naxLength": 256, 
"type": "string" 
Lh 
{ 


"description": "Unique identifier (UUID)", 
"pattern": "^[a- fA - F0 - 9](8) - [a- fA— F0 - 9](4) - [a- fA- F0- 9](4) - [a- fA- F0- 
9](4) - [a- fA- F0 - 9](12) $", 
"type": "string" 
) 
] 
}, 
"p": { 
"description": "Specifies the framework policies on the Resource referenced by the target URI", 
"properties": { 
"ba": { 
"description": "Specifies the framework policies on the Resource referenced by the target 
URI for e.g. observable and discoverable", 
"type": "integer" 


: "object" 


"rel": { 
"description": "The relation of the target URI referenced by the link to the context URI", 
"oneOf": [ 
{ 
"default": [ 
"hosts" 
l 
"items": { 
"maxLength" : 64, 
"type": "string" 


ninItens": 1, 
": "array" 


"default": "hosts", 
"naxLength": 64, 
"type": "string" 


} 

"rt": { 
"description": "Resource Type", 
"items": { 


"maxLength": 64, 
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"type": "string" 
}, 
"minItems": 1, 
"type": "array" 
b 
"title": { 
"description": "A title for the link relation. Can be used by the UI to provide a context", 
"maxLength": 64, 
"type": "string" 
)h 
"type : ( 
"default": "application/cbor", 
"description": "A hint at the representation of the resource referenced by the target URI. This 
represents the media types that are used for both accepting and emitting", 
"itens": ( 
"maxLength" : 64, 
"type" : "string" 
b 


"minItems": 1, 


"type": "object" 
} 
} 
} 



































2. 属性 定义 
属性 定义 如 表 10-21 所 示 。 
表 10-21 属性 定义 
属 性 名 属性 值 类 型 访问 模式 | 是 否 强制 fi xk 
mpro 字符 串 只 读 支持 的 消息 协议 
links 数组 是 
if 数组 RE 是 该 资源 支持 的 接口 集 
n 字符 串 只 读 人 性 化 名 称 
rt 数组 只 读 资源 类 型 
di 多 类 型 设备 唯一 标识 符 
title 字符 串 链接 关系 标题 ,可 用 来 提供 界面 内 容 
eps 数组 目标 资源 的 终端 信息 
P 项 目 规定 从 目标 URI 引用 资源 的 框架 策略 
ins 多 类 型 集合 中 使 用 的 链接 数组 中 Web 实例 标识 符 
href ph 是 目标 URI, 它 可 以 被 指定 为 相对 引用 或 完全 限定 的 
URI。 应 该 与 di" 参数 一 起 使 用 ,使 其 能 够 唯一 
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续 表 
属 性 名 属性 值 类 型 | 访问 模式 | 是 否 强制 描 述 
ki 提示 由 目标 URI 引 用 的 资源 表示 ,用 于 接收 和 发 送 的 
did 媒体 类 型 
anchor Tf 用 于 覆盖 内 容 URI, 例 如 ,覆盖 包含 集合 的 URI 
rel 多 类 型 内 容 URI 链 接 引 用 目标 URI 的 关系 
3. CRUDN 行为 
CRUDN 行为 如 表 10-22 所 示 。 
表 10-22 CRUDN 行为 
Xo 源 创建 检索 更 新 删除 通知 





/oic/res get 




















10.12 场景 


该 资源 是 通用 集合 资源 ,“rts” 值 应 包含 oic. sceneCollection” 资 源 类 型 ,提供 指向 场景 的 当前 网 络 
连接 列表 。URI 示例 为 /SceneListResURI”, 资 源 类 型 为 “oic. wk. scenelist” “oic. wk. scenemember" 
"oic. wk. scenecollection” , 

1. Swagger 2. 0 定义 


( 
"swagger": "2.0", 
"iste" 
"title": "Scenes (Top level)", 
"version": "vi- 20160622", 
"license": ( 

"name": "copyright 2016 - 2017 Open Connectivity Foundation, Inc. All rights reserved. ", 

"x - description": "Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met:\n 1. Redistributions of source code must retain 
the above copyright notice, this list of conditions and the following disclaimer. Vn 2. Redistributions in 
binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer 
in the documentation and/or other materials provided with the distribution. \n\n THIS SOFTWARE IS PROVIDED BY 
THE Open Connectivity Foundation, INC. \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES OF 
NON — INFRINGEMENT, ARE DISCLAIMED. Vn IN NO EVENT SHALL THE Open Connectivity Foundation, INC. OR 
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) Vn HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Vn" 

} 
) 
"schemes": ["http"], 
"consumes": ["application/json"], 
"produces": ["application/json"], 
"paths": ( 
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"/SceneListResURI" : { 
"get": ( 

"description": "Toplevel Scene resource. \nThis resource is a generic collection resource. \nThe rts 
value shall contain oic. wk. scenecollection resource types. \nProvides the current list of web links pointing 
to scenes\n", 

"parameters": [ 


L 
"responses": { 
"200": { 
"description" : "", 
"x - example": 
t 
"rt": ["oic. wk. scenelist"], 
"n": "list of scene Collections", 
"rts": ["oic. wk. scenecollection"], 
"links": [ 
] 
H 
g 
"schema": ( " $ ref": " # /definitions/Collection" } 
) 
) 
) 
» 
"/SceneMemberResURI" : { 
"get": { 


"description": "Collection that models a scene member. \nProvides the scene member\n", 
"parameters": [ 


"responses" : ( 
"200": ( 
"description" : "", 
"x— example": 
{ 


"rt": ["oic. wk. scenenember"], 
"id": "0685B960 — FFFF — 46F7 — BECO — 9E6234671ADC1", 
"n": "my binary switch (for light bulb) mappings", 
"link": ( 

"href": "binarySwitch", 

"rt": ["oic.r. switch. binary" ], 
if": ["oic. 








f.a", "oic.if.baseline"], 





{"ep": "coap://[£e80: :b1d6]:1111", "pri": 2}, 
("ep" : "coaps://[ fe80: :b1d6] :1122"), 


{"ep": "coap + tcp://[2001:db8:a::123]:2222", "pri": 3} 

] 

}, 

"sceneMappings" : [ 

{ 

"scene" : "off", 
"memberProperty": "value", 
"nenberValue" : true 


Lh 
t 
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"scene": "Reading", 
"menberProperty": "value", 
"nenberValue" : false 
L 
{ 
"scene" : "TVWatching", 
"memberProperty": "value", 
"nenberValue" : true 
} 
] 
} 
"schema": { " $ ref": "#/definitions/SceneMember" } 
} 
} 
} 
Lh 
"/SceneCollectionResURI" : ( 
"get": ( 


"description": "Collection that models a set of Scenes. VnThis resource is a generic collection 
resource with additional parameters. VnThe rts value shall contain oic. scenemember resource types. VnThe 
additional parameters are\n lastScene, this is the scene value last set by any OCF Client\n sceneValues, this 
is the list of available scenes\n lastScene shall be listed in sceneValues. \nProvides the current list of web 
links pointing to scenes Wn", 

"parameters": [ 








1, 
"responses": { 
"200": { 
"description" : "", 
"x- example": 
{ 
"lastScene" : "off", 
"sceneValues" : "off, Reading, TVWatching", 
["oic. wk. scenecollection"], 
"My Scenes for my living room", 
"0685B960 - 736F — 46F7 — BECO — 9E6CBD671ADC1", 
["oic. wk. scenemember" ], 
iE 
} 
"schema": ( " $ ref": "#/definitions/SceneCollection" } 
) 
} 
Lh 
"post": ( 
"description": "Provides the action to change the last set scene selection. \nCalling this method 


shall update all scene members to the prescribed membervalue. \nWhen this method is called with the same value 
as the current lastScene value\nthen all scene members shall be updated. n", 
"parameters": [ 
1 
"nane" : "body", 
"in": "body", 
"required": true, 
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"schema": ( " $ ref": "#/definitions/SceneCollectionUpdate" ), 


"x — example": 


{ 
"lastScene": "Reading" 


} 
1, 
"responses": { 
"200": { 
"description" : "Indicates that the value is changed. \nThe changed properties are provided 
in the response. \n", 
"x— example": 
{ 
"lastScene" : "Reading" 


) 


"schema": ( " $ ref": "# /definitions/SceneCollectionUpdate" } 


) 
) 
} 
} 


}, 
"parameters": { 
"interface 





"if", 


string", 
["oic.if.a", "oic.if.11", "oic.if.baseline"] 





}, 
"definitions": { 
"Collection" : 
{ 
"description": "A set (array) of simple or individual OIC Links. In addition to properties required 
for an OIC Link, the identifier for that link in this set is also required", 
"items": { 
"properties": 
"anchor": { 
"description": "This is used to override the context URI e.g. override the URI of the 





containing collection", 
"format": "uri", 
"maxLength" : 256, 


"type": "string" 


"di":( 
"description": "Unique identifier for device (UUID)", 
"^[a- fA- F0 - 9](8) - [a- £A F0 - 9][4] - [a- fA- FO - 9](4) - [a- fA- FO - 9] 


"pattern": 
{4} -[a- fa- FO- 9](12) $", 
"type": "string" 


"drel": { 
"description": "When specified this is the default relationship to use when an OIC Link does 


not specify an explicit relationship with * rel* parameter", 
"type": "string" 
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) 

"eps": ( 
"description": "the Endpoint information of the target Resource", 
"items": ( 





"description": "The priority among multiple Endpoints as specified", 
"minimun": 1, 
"type": "integer" 


: "object" 
: "array" 


"href": ( 
"description": "This is the target URI, it can be specified as a Relative Reference or fully- 
Relative Reference should be used along with the di parameter to make it unique. ", 
"format": "uri", 
"maxLength" : 256, 
"type": "string" 
} 
"id':d 
"description": "Instance ID of this specific resource", 
"maxLength" : 64, 
"readOnly": true, 
"type": "string" 
Lh 
"alto 
"description": "The interface set supported by this resource", 
"items": { 
"enun" : [ 
"oic. if. baseline", 
*oic.itf.i", 
if. b", 
.iforw", 


qualified URI. 


SES z^, 
.if.a", 
af a" 


: "string" 


"minItems": 1, 
"type": "array" 
B 
"ins": d 
"description": "The instance identifier for this web link in an array of web links - used in 
collections", 
"oneOf": [ 
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{ 
"description": "An ordinal number that is not repeated - must be unique in the 


collection context", 
"type" 
h 
{ 
"description": "Any unique string including a URI", 
"format": "uri", 
"maxLength" : 256, 
"type": "string" 
] 
{ 
"description": "Unique identifier (UUID)", 
"pattern": "^[a- fA- F0 - 9](8) - [a- fA- F0 - 9](4) - [a- fA- FO - 9](4) - [a- fA- 
F0-9](4) - [a- fA- FO-9]{12}$", 
"type": "string" 





" integer" 


"links": ( 
"description": "All forms of links in a collection", 
"oneOf": [ 
{ 
"description": "A set (array) of simple or individual OIC Links. In addition to 
properties required for an OIC Link, the identifier for that link in this set is also required", 
"items": { 
"properties": { 
"anchor" : ( 
"description": "This is used to override the context URI e.g. override the URI of 
the containing collection", 
"format": "uri", 
"maxLength": 256, 
"type": "string" 
) 
"a": f 
"description": "Unique identifier for device (UUID)", 
"pattern": "^[a- fA- F0 - 9](8) - [a- fA- F0- 9](4) - [a- fa- F0 -9]{4} - [a- 
fA- F0- 9](4) - [a- £a- FO - 9)(12) $", 
"type": "string" 
) 


"eps": ( 
"description": "the Endpoint information of the target Resource", 
"items": ( 
"properties": ( 
"ep": { 
"description": "URI with Transport Protocol Suites + Endpoint Locator as 
specified", 
"format": "uri", 
"type": "string' 
Lh 
"pri*: { 


"description": "The priority among multiple Endpoints as specified", 
"ninimum": 1, 
"type": "integer" 
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} 
Lh 
"type": "object 
Lh 
"type": "array" 
h 
"href": { 


"description": "This is the target URI, it can be specified as a Relative Reference or 


fully- qualified URI. Relative Reference should be used along with the di parameter to make it unique. ", 
"format": "uri", 


"naxLength": 256, 





"description": "The instance identifier for this web link in an array of web links — 
used in collections", 
"oneOf": [ 
t 
"description": "An ordinal number that is not repeated - must be unique in 
the collection context", 
"type": "integer" 
h 
{ 
"description": "Any unique string including a URI", 
"format": "uri", 
"naxLength" : 256, 
"type": "string" 
Lh 
t 
"description": "Unique identifier (UUID)", 
"pattern": "^[a- fA- F0 - 9](8) - [a- £A- F0 - 9](4) - [a- fA- FO-9]{4} — 
[a- faA- F0- 1 9](4] - [a- f£A- F0O- 9](12] $", 
"type": "string" 
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"description": "Specifies the framework policies on the Resource referenced by 
the target URI", 
"properties": ( 
"bm": ( 
"description": "Specifies the framework policies on the Resource referenced 
by the target URI for e.g. observable and discoverable", 
"type": "integer" 


"type": "object" 
n 


"rel": { 
"description": "The relation of the target URI referenced by the link to the 
context URI", 
"oneOf": [ 
{ 
"default": [ 
"hosts" 
l 
"items": { 


"naxLength": 64, 
"type": "string" 
}, 
"minItems": 1, 
"type": "array" 


D 
{ 
"default": "hosts", 
"maxLength": 64, 
"type": "string" 
} 
] 
) 
"rto 
"description": "Resource Type", 
"items": { 
"maxLength" : 64, 


"type": "string" 
1, 
"minItems": 1, 
"type": "array" 
h 
"title": { 
"description": "A title for the link relation. Can be used by the UI to 
provide a context", 


"type": { 
"default": "application/cbor", 
"description": "A hint at the representation of the resource referenced by the 
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target URI. This represents the media types that are used for both accepting and emitting", 


"itens": ( 


"naxLength" : 64, 
"type": "string! 


Lh 
"ninItens": 1, 
"type": "array" 


"ats 


"description": "Friendly name of the resource", 


"maxLength": 64, 
"readOnly": true, 
"type": "string" 


"p": { 


"description": "Specifies the framework policies on the Resource referenced by the target URI", 


"properties": { 
"bm": ( 


"description": "Specifies the framework policies on the Resource referenced by the target URI 


for e.g. observable and discoverable", 
"integer" 





B 


"description": "The relation of the target URI referenced by the link to the context URI", 


"oneOf": [ 
{ 
"default": [ 
"hosts" 


"minItems": 1, 
"type": "array" 
} 
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{ 


"default": "hosts", 
"naxLength": 64, 
"type": "string" 


h 
"rt": { 
"description": "Resource Type", 
"items": { 
"maxLength": 64, 
"type": "string" 
Lh 
"minItems": 1, 
"type": "array" 


"description": "Defines the list of allowable resource types (for Target and anchors) in 
links included in the collection; new links being created can only be from this list", 
"items": { 
"maxLength" : 64, 
"type": "string" 
) 
"ninItems": 1, 
"readOnly": true, 
"type": "array" 
n 
"title": ( 
"description": "A title for the link relation. Can be used by the UI to provide a context", 
"maxLength" : 64, 
"type": "string" 
Lh 
"type": { 
"default": "application/cbor", 
"description": "A hint at the representation of the resource referenced by the target URI. 
This represents the media types that are used for both accepting and emitting", 
"items": { 
"maxLength" : 64, 


: "string" 





"href", 


": "object" 


type": "array" 
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"SceneMember" : 
t 
"properties": ( 
"SceneMappings": { 
"description": "array of mappings per scene, can be 1", 
"items": ( 
"properties": ( 
"nenberProperty" : { 
"description": "property name that will be mapped", 
"readOnly": true, 
"type": "string" 
) 
"memberValue" 
"description": "value of the Member Property", 
"readOnly": true, 
"type": "string" 





Lh 
"scene": ( 
"description": "Specifies a scene value that will acted upon", 
"type": "string" 


"menberProperty", 
"menberValue" 


"type": "object" 


"idi 
"description": "Can be an value that is unique to the use context or a UUIDv4" 
"type": "string" 
Lh 
XE 
"description": "The interface set supported by this resource", 
"items": { 
"enum": [ 
"oic. if. baseline", 
"oic.if.ll", 


: "string" 
}, 
"minItems": 1, 
"readOnly": true, 
"type" : "array" 

B 
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"Link": { 
"description": "web link that points at a resource", 
"properties": ( 
anchor": ( 
"description": "This is used to override the context URI e.g. override the URI of the 
containing collection", 
"format": "uri", 
"maxLength": 256, 
"type" : "string" 
Lh 
"di": { 
"description": "Unique identifier for device (UUID)", 
"pattern": "^[a- fA- F0 - 9](8) - [a- £A- F0 - 9](4) - [a- fA- FO - 9](4) - [a- fA- FO — 
9](4) - [a- fa- F0- 9](12) $", 
"type" : "string" 


) 
"eps": ( 
"description": "the Endpoint information of the target Resource", 
"items": ( 
"properties": ( 
"ep": { 
"description": "URI with Transport Protocol Suites + Endpoint Locator as specified", 
"format": "uri", 
"type": "string" 
) 
"pet" sp 
"description": "The priority among multiple Endpoints as specified", 
"minimum": 1, 
"type": "integer" 
} 
) 
"type": "object" 
) 
"type" : "array' 
) 
"href": ( 


"description": "This is the target URI, it can be specified as a Relative Reference or 
fully- qualified URI. Relative Reference should be used along with the di parameter to make it unique. ", 


"format": "uri", 


"naxLength": 256, 





"type": "string' 
} 
g agi 
"description": "The interface set supported by this resource", 


"items": { 


if. baseline", 
EA 
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"type": "string" 


Lh 
"ninItens": 1, 
"type": "array" 
Lh 
"ins": ( 


"description": "The instance identifier for this web link in an array of web links — used 
in collections", 


"oneOf": [ 
t 
"description": "An ordinal number that is not repeated - must be unique in the 
collection context", 
"type": "integer" 
Lh 
t 


"description": "Any unique string including a URI", 
"format": "uri", 
"maxLength" : 256, 
"type": "string" 
) 
t 


"description": "Unique identifier (UUID)", 
"pattern": "^[a- fA F0 - 9](8) - [a- fA- F0 - 9](4) - [a- fA- F0 - 9](4) - [a- fA- 
F0-9](4) - [a- fA- FO- 9](12) $", 
"type": "string" 
) 
] 
) 
"pr 
"description": "Specifies the framework policies on the Resource referenced by the target 


"properties": ( 
"ba": ( 
"description": "Specifies the framework policies on the Resource referenced by the 
target URI for e.g. observable and discoverable", 
"type": "integer" 


"rel": ( 
"description": "The relation of the target URI referenced by the link to the context URI", 
"oneO£" : [ 
t 
"default": [ 
"hosts" 
l 
"items": { 
"naxLength": 64, 
"type": "string" 
hn 
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"minItems": 1, 
"type": "array" 
Lh 
t 


"default": "hosts", 
"maxLength" : 64, 
"type": "string" 


"re": ( 
"description": "Resource Type", 
"items": { 

"maxLength": 64, 

": "string" 


"minItems": 1, 
"type" : "array' 

) 

"title": ( 
"description": "A title for the link relation. Can be used by the UI to provide a context", 
"maxLength" : 64, 

"type": "string" 
) 
"type": ( 
"default": "application/cbor", 
"description": "A hint at the representation of the resource referenced by the target URI. 
This represents the media types that are used for both accepting and emitting", 


"items": { 
"maxLength": 64, 
"type": "string" 
Lh 
"minItems": 1, 
"type": "array" 
) 
) 
"required": [ 
"href", 
"rt", 
vig" 
L 
"type": "string' 
) 
*ati d 


"type": "string" 


"description": "Resource Type", 
"items": { 
"naxLength" : 64, 
"type": "string" 
) 


"minItems": 1, 





248 «|| OCF 技 术 原理 及 物 联网 程序 开发 指南 


"readOnly": true, 
"type": "array" 
) 
Lh 
"required": [ 
"link" 
l 
"type": "object" 
) 


"SceneCollection" : 
{ 
"properties": { 
"id": { 
"description": "A unique string that could be a hash or similarly unique", 
"type": "string" 
Lh 
Tug 
"description": "The interface set supported by this resource", 
"items": ( 
"enun": [ 
"oic. if. baseline", 
"oic. if.11", 


minItems": 1, 


"lastScene": ( 
"description": "Last selected Scene, shall be part of sceneValues", 
"type": "string" 


"links": ( 
"description": "Array of OIC web links that are reference from this collection", 
"itens": ( 
"allof": [ 
{ 
"properties": { 
"anchor": { 
"description": "This is used to override the context URI e.g. override the URI of 
the containing collection", 
"format": "uri", 
"naxLength": 256, 
"type": "string" 
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"description": "Unique identifier for device (UUID)", 
"pattern": "^[a — fA- F0 - 9] (8) - [a- fA- FO - 9](4) - [a- fA- F0 - 9](4) - [a- 
fA-F0-9](4)-[a- fA-F0-9]{12} $", 
"type": "string" 
B 
"eps": { 
"description": "the Endpoint information of the target Resource", 
"itens": { 
"properties": { 
"ep": { 
"description": "URI with Transport Protocol Suites + Endpoint Locator as 
specified in 10.2.1", 


"description": "The priority among multiple Endpoints as specified", 
"minimum": 1, 
"type": "integer" 


: "array" 


"href": { 
"description": "This is the target URI, it can be specified as a Relative Reference 
or fully- qualified URI. Relative Reference should be used along with the di parameter to make it unique. ", 
"format": "uri", 
"maxLength" : 256, 
"type": "string" 


ak i 
"description": "The interface set supported by this resource", 
"items": { 
"enum": [ 
"oic. if. baseline", 
“ole. 1£.11", 


"description": "The instance identifier for this web link in an array of web links — 
used in collections", 
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"description": "An ordinal number that is not repeated — must be unique in the 


collection context", 





"type": "integer" 


Lh 


"description": "Any unique string including a URI", 
"format": "uri", 
"maxLength": 256, 
"type": "string" 
Lh 
{ 


"description": "Unique identifier (UUID)", 
"pattern": "^[a- fA- F0 - 9](8) - [a- fA- F0 - 9](4) - [a- fA- FO - 9](4) — 
[a-fA-F0-9](4)- [a-fA-FO-9](12) $", 
"type": "string" 
) 
] 
Lh 
"p": { 
"description": "Specifies the framework policies on the Resource referenced by the 
target URI", 
"properties": { 
"ba": { 
"description": "Specifies the framework policies on the Resource 
referenced by the target URI for e.g. observable and discoverable", 
"type": "integer" 


: "object" 


"description": "The relation of the target URI referenced by the link to the context 
URI", 
"oneOf" : [ 
{ 
"default": [ 
"hosts" 


"default": "hosts", 
"naxLength": 64, 
"type": "string" 
H 
] 
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) 

"sd. 
"description": "Resource Type", 
"itens": ( 


"maxLength" : 64, 
"type": "string" 
) 
"minItems": 1, 
"type" : "array" 
B 
"title": { 
"description": "A title for the link relation. Can be used by the UI to provide a 
context", 


"type": { 
"default": "application/cbor", 
"description": "A hint at the representation of the resource referenced by the 
target URI. This represents the media types that are used for both accepting and emitting", 
"items": { 
"maxLength" : 64, 
"type": "string" 
Lh 
"minItems": 1, 
"type": "array" 


"required": [ 
"href", 
"rt", 
"ig" 
l 
"type": "object" 
L 
{ 
required”: [ 
"ins" 
] 
} 
1 
) 
"type": "array" 
Lh 
"a": { 


"description": "Used to name the Scene collection", 
"type": "string" 
Lh 
ppt: 
"description": "Resource Type", 
"items": { 
"maxLength" : 64, 
"type": "string" 
B 
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"ninItens": 1, 
"readOnly": true, 
"type": "array" 


Peta sf 
"description": "Defines the list of allowable resource types in links included in the 
collection; new links being created can only be from this list", 
"items": { 
"maxLength" : 64, 
"type": "string" 
}, 
"minItems": 1, 
"readOnly": true, 
"type": "array" 
n 
"sceneValues" : { 
"description": "All available scene values", 
"readOnly": true, 
"type": "string" 


required": [ 
"lastScene", 


"sceneValues", 


rts", 
"id" 
1, 
"type": "object" 
} 


r 
"SceneCollectionUpdate" : 
{ 
"properties": { 
"4d s 
"description": "A unique string that could be a hash or similarly unique", 
"type": "string" 
}, 
"ei 
"description": "The interface set supported by this resource", 
"items": { 
"enum": [ 
"oic. if. baseline", 
oic.if.ll", 


: "string" 


"ninItens": 1, 
"readOnly": true, 
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"type" : "array" 
Lh 
"lastScene": { 
"description": "Last selected Scene, shall be part of sceneValues", 
"type": "string" 


"links": ( 
"description": "Array of OIC web links that are reference from this collection", 
"items": { 
"allof": [ 
{ 
"properties": { 
anchor": { 
"description": "This is used to override the context URI e.g. override the URI of 
the containing collection", 
"format": "uri", 
"maxLength" : 256, 
"type": "string" 


"di": { 
"description": "Unique identifier for device (UUID)", 
"pattern": "^[a— fA - F0 - 9](8) - [a- £A-FO-9]{4} - [a- fA- FO-9]{4} - [a fA 
-F0-9](4)-[a- fA-F0-9](12)$ ", 
"type" : "string" 
h 


"eps": { 
"description": "the Endpoint information of the target Resource", 
"items": { 
"properties": { 
"ep": { 
"description": "URI with Transport Protocol Suites + Endpoint Locator as 
specified", 
"format": "uri", 
"type": "string" 
Lh 
"pri": ( 
"description":"The priority among multiple Endpoints as specified ", 
"minimum": 1, 
"type": "integer" 


: "object" 


"href": { 
"description": "This is the target URI, it can be specified as a Relative Reference 
or fully- qualified URI. Relative Reference should be used along with the di parameter to make it unique. ", 


"format": "uri", 


"ie": { 
"description": "The interface set supported by this resource", 
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: "string" 


"minItems": 1, 
"type": "array" 


n 
"ins": ( 
"description": "The instance identifier for this web link in an array of web links — 
used in collections", 
"oneOf": [ 


{ 
"description": "An ordinal number that is not repeated - must be unique in the 
collection context", 
"type": "integer" 
L 
{ 


"description": "Any unique string including a URI", 
"format": "uri", 
"maxLength": 256, 
"type": "string" 
} 
{ 


"description": "Unique identifier (UUID)", 
"pattern": "^[a- fA- F0 - 9](8) - [a- fA- F0 - 9](4) - [a- fA- FO - 9](4) - 
[a-fA- F0-9](4)- [a-fA-FO-9](12) $", 
"type": "string" 
} 
] 
Lh 
"p": ( 
"description": "Specifies the framework policies on the Resource referenced by the 
target URI", 
"properties": ( 
"bm": { 
"description": "Specifies the framework policies on the Resource referenced by 
the target URI for e.g. observable and discoverable", 
"type": "integer" 
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"description": "The relation of the target URI referenced by the link to the context 
URI", 
"oneOf": [ 
{ 
"default": [ 
"hosts" 
l 
"items": ( 
"maxLength": 64, 


"default": "hosts", 
"maxLength": 64, 
"type": "string" 
) 
] 
) 
"rt": { 
"description": "Resource Type", 
"items": ( 
"naxLength": 64, 
"type": "string" 
) 
"ninItems": 1, 
"type": "array" 
Lh 
"title": ( 
"description": "A title for the link relation. Can be used by the UI to provide a 
context", 


"type": { 
"default": "application/cbor", 
"description": "A hint at the representation of the resource referenced by the 
target URI. This represents the media types that are used for both accepting and emitting", 
"items": { 


minItems": 1, 


"type": "array" 
; 
h 
"required": [ 
"href", 
"rh, 
vig" 
l 
"type": "object" 
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"description": "Used to name the Scene collection", 
"type": "string" 


) 

"rt": ( 
"description": "Resource Type", 
"items": { 


"maxLength" : 64, 
"type": "string" 
) 
"minItems": 1, 
"readOnly": true, 
"type": "array" 
n 
"rts": d 
"description": "Defines the list of allowable resource types in links included in the 
collection; new links being created can only be from this list", 
"itens": ( 


"ninItens": 1, 
"readOnly": true, 
"type": "array" 
L 
"sceneValues": ( 
"description": "All available scene values", 
"readOnly" : true, 
"type": "string" 
} 
}, 
"required": [ 
"lastScene" 
L 
"type": "object" 


} 


2. 属性 定义 
属性 定义 如 表 10-23 所 示 。 
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X1023 属性 定义 
属 性 名 属性 值 类 型 | 访问 模式 | 是 否 强制 do xk 

Em 多 类 型 定义 了 集合 中 包含 链接 中 允许 的 资源 类 型 (对 于 目标 
和 锚 点 ) 的 列表 ,正在 创建 的 新 链接 只 能 来 自 此 列表 

didi "— 在 OCF 链接 未 通过 “rel” 参 数 指明 一 个 显 式 关系 时 , 指 
定 使 用 该 默认 关系 

lastScene 字符 串 读 写 是 最 后 选择 的 场景 ,应 该 是 “sceneValues” 的 一 部 分 

sceneValues 字符 串 只 读 是 所 有 可 用 的 场景 值 

n 字符 串 读 写 用 于 命名 场景 集合 

id x 读 写 是 一 个 唯一 的 字符 串 

links 数组 读 写 从 该 集合 中 引用 的 OCF Web 链接 数组 

id Tm 读 写 可 以 是 对 使 用 上 下 文 或 UUIDv4 唯一 的 值 

SceneMappings 数组 读 写 每 个 场景 的 映射 数组 ,可 以 是 1 

link 字符 串 读 写 是 指向 一 个 资源 的 Web 链接 

rt 数组 只 读 资源 类 型 

if 数组 只 读 资源 支持 的 接口 集合 

"ma 数组 提示 由 目标 URI 引用 的 资源 表示 ,用 于 接收 和 发 送 的 
媒体 类 型 

n 字符 串 只 读 人 性 化 名 称 

id 字符 串 只 读 指定 资源 的 ID 示例 

di 多 类 型 设备 唯一 标识 符 

anchor 字符 串 用 于 覆盖 内 容 URI, 例 如 ,覆盖 包含 集合 的 URI 

rel 多 类 型 内 容 URI 链接 引用 目标 URI 的 关系 

title 字符 串 链接 关系 标题 ,可 被 URI 用 来 提供 内 容 

eps 数组 目标 资源 的 终端 信息 

p 对 象 规定 从 目标 URI 引用 资源 的 框架 策略 

3. CRUDN 行为 


CRUDN 行为 如 表 10-24 所 示 。 


Xo 源 


创建 


表 10-24 CRUDN 行为 


检索 更 新 删除 通知 





/SceneListResURI | 
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CHAPTER 11 








OCF 核心 规范 指定 了 可 以 实现 IoT 用 法 和 生态 系统 的 OCF 框架 。 该 OCF 核心 框架 可 扩展 支持 
那些 简单 设备 ( 受 限 性 设备 ) 和 更 多 功能 性 设备 (智能 设备 ) 。 

本 章 基于 OCF 核心 规范 所 定义 资源 类 型 ,详细 说 明 那 些 已 经 被 OCF 定义 或 者 有 可 能 被 OCF 设备 
使 用 到 的 资源 , 列 出 OCF 当前 指定 的 所 有 资源 类 型 。 资 源 由 应 用 程序 配置 文件 设备 定义 使 用 ,本 章 提 
及 的 资源 类 型 ,可 以 由 任何 在 OCF 集合 里 或 设备 代表 中 的 OCF 认证 设备 所 使 用 。 

应 用 程序 配置 文件 设备 规范 (例如 ,为 智慧 家 居 和 医疗 保健 所 创建 的 ) 指 定 了 适合 于 该 配置 文件 的 
设备 类 型 ,这 些 规范 使 用 了 本 章 定义 的 资源 类 型 。 


11.1 基准 模型 构造 


11.1.1 概述 


本 部 分 对 资源 类 型 的 构建 基础 做 简单 的 描述 。 

1. URI 

本 章 提 到 的 URI 是非 规 范 化 的 ,可 能 是 供应 商定 义 的 。 一 个 资源 的 实例 由 URI 指示 。 当 一 个 
OCF 设备 中 的 同一 个 资源 类 型 多 于 一 个 实例 时 ,需要 使 用 不 同 URI 来 为 不 同 的 实例 做 指示 。 其 实现 应 
遵循 OCF 核心 规范 中 关于 URI 群体 定义 的 要 求 ,详细 说 明 请 参考 本 书 的 第 2 章 。 

2. 接口 

OCF 核心 规范 指定 所 有 资源 类 型 至 少 有 一 个 接口 与 它们 关联 ,这 个 接口 在 资源 发 现 阶段 会 被 广 
播 。 此 外 ,OCF 核心 规范 定义 了 许多 可 以 被 资源 类 型 实例 所 应 用 的 接口 。 

本 部 分 定义 的 所 有 资源 类 型 相关 联 的 默认 接口 ,应 为 资源 类 型 定义 中 枚 举 列 出 的 支持 接口 ,除非 资 
源 类 型 定义 具有 传感器 或 执行 器 接口 作为 默认 接口 。 在 这 种 情况 下 ,应 选择 其 中 一 个 作为 默认 接口 。 
因此 ,托管 这 样 资 源 类 型 的 服务 器 端 ,应 该 允许 *oic. if. s”( 传 感 器 接口 ) 或 “oic. if. a”( 执 行 器 接口 ) 作 为 
经 由 “/oic/res” 暴 露 的 接口 ,以 及 被 授权 的 基准 接口 (“oic. if. baseline”)。 除 了 指定 为 默认 的 接口 之 外 ， 
服务 器 端 还 可 以 支持 其 他 接口 。 

注意 ,被 设备 所 暴露 的 那些 有 关 资 源 实例 可 见 的 功能 ,应 该 遵循 当地 (每 个 国家 或 立法 地 区 ) 的 监管 
要 求 或 其 他 限制 (例如 ,在 一 些 管辖 地 区 ,用 二 进 制 开 关 去 远程 上 电 一些 连 接 设备 是 受 限 制 的 ; 锁定 状 
态 可 以 是 只 读 的 ,取决 于 上 下 文 )。 在 这 种 情况 下 .设备 不 应 暴露 资源 的 执行 器 接口 (“oic. if. a”) ,设备 
应 使 用 “/oic/res” 的 传感器 接口 (“oic. if. s”) 作 为 默认 接口 以 及 任何 强制 接口 。 
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3. RAML 定义 

本 部 分 使 用 的 RAML 定义 是 规范 性 的 ,扩展 所 有 定义 的 JSON 有 效 载荷 应 符合 指定 的 JSON EE 
式 , 定 义 的 模式 包括 所 有 OCF 核心 规范 定义 (强制 ) 属 性 的 扩展 。 

RAML 定义 用 于 描述 指定 资源 类 型 上 CRUDN 操作 的 有 效 载 苟 。CRUDN 操作 在 OCF 核心 规范 
HEX, OCF 核心 规范 还 指定 CRUDN 操作 的 有 效 内 容 中 的 附加 属性 。 本 章 文档 中 的 RAML 定义 本 
身 不 足以 创建 实现 ,需要 添加 在 核心 规范 中 定义 的 附加 属性 来 创建 兼容 实现 。 本 章 使 用 RAML 特定 支 
持 的 响应 子 集 , 对 这 些 响应 的 使 用 ,在 表 5-4 中 定义 了 RAML 中 的 返回 码 。 请 注意 ,成 功 和 错误 条 件 的 
实际 值 是 在 OCF 核心 规范 中 定义 的 。 

RAML 定义 将 OCF CRUDN 行为 映射 到 表 11-1 中 定义 的 RAML。 

表 11-1 CRUDN 5 RAML 定义 之 间 的 转换 
x 源 创建 检索 更 新 删除 通知 


/example put 或 post get put 或 post delete 








通知 不 是 RAML 定义 的 一 部 分 ,而 是 在 核心 规范 中 定义 的 。 通 知 的 语义 与 CRUDN 检索 值 相同 。 
在 本 部 分 定义 的 所 有 资源 类 型 ,都 支持 在 本 书 的 第 6 章 OCF 的 功能 交互 中 定义 的 通知 。 


11.1.2 属性 定义 


本 节 介绍 公共 属性 、 资 源 属性 和 基本 资源 模式 。 
1. 公共 属性 
OCF 核心 规范 指定 了 大 量 可 能 被 OCF 资源 所 定义 的 属性 。 公 共 属 性 "if” 和 “rt" 应 该 被 所 有 在 本 部 
分 定义 的 资源 类 型 指定 ; 它们 通过 发 现 OCF 服务 器 端 和 它 的 可 用 资源 , 巾 OCF 核心 规范 定义 的 /oic/ 
res” 资 源 类 型 来 公开 。 公 共 属 性 *p” 和 *n” 可 以 被 本 部 分 定义 的 所 有 资源 类 型 所 指定 ,公共 属性 如 表 11-2 
所 示 。 
表 11-2 ”OCF 资源 的 公共 属性 























属性 名 属性 标题 | 属 性 值 | 属性 值 类 型 | 访问 模式 d 述 
if 接口 参见 第 3 章 字符 串 只 读 核心 规范 定义 ; 资源 支持 的 接口 
x 核心 规范 定义 ; 资源 类 型 。 资 源 类 型 在 本 
rt 资源 类 型 | 参见 第 3 章 字符 串 只 读 部 分 定义 
n 名 称 参见 第 3 章 字符 串 只 读 核心 规范 定义 ; 人 类 可 以 理解 的 资源 名 称 
id ID 参见 第 3 章 字符 串 只 读 核心 规范 定义 ; 资源 的 唯一 标识 符 











如 果 OCF 客户 端 要 求 这 些 属性 包含 在 响应 检索 操作 提供 的 资源 表示 中 , 则 客户 端 应 通过 在 查询 参 
数 中 指定 此 属性 来 选择 OCF 核心 规范 定义 的 基准 接口 (“oic. if. baseline”)。 

建议 托管 支持 批 处 理 接口 的 智能 家 居 设 备 集合 用 *oic. if. baseline” 填 充 “bifLink” 参 数 , 用 于 集合 中 
的 所 有 资源 。 这 是 为 了 确保 对 集合 的 检索 操作 在 响应 中 提供 公共 属性 “rt” 和 *if”。 

2. 资源 属性 

指定 CRUDN 操作 的 属性 是 使 用 JSON 模式 定义 的 (请 参阅 JSON Schema). SEA BE WIS HE FA 
绕 表 示 物 理 属性 的 单个 值 来 表达 的 。 此 类 资源 类 型 使 用 表 11-3 定义 的 属性 指定 。 表 中 的 “强制 性 ” 意 
味 着 该 属性 应 被 定义 为 整体 资源 类 型 模式 的 一 部 分 ; 实际 包含 属性 作为 返回 或 生成 有 效 载荷 的 一 部 
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分 ,取决 于 被 调用 的 操作 模式 。 
表 11-3 JSON 模式 中 资源 类 型 的 属性 定义 


属性 名 | 属性 标题 属 性 值 | 属性 值 类 型 | 属性 值 规则 | 访问 模式 是 否 强 制 LEE. 
Value 取决 于 资源 | 取决 于 资源 取决 于 资源 | 取决 于 资源 | 取决 于 资源 是 资源 的 当前 值 























r 输入 值 的 范围 , 指 
Range 范围 [最 小 值 , 最 大 值 ]| 数组 线性 范围 | 只 读 否 定 为 两 个 元 素数 组 
Step 步 长 取决 于 资源 整数 或 数字 | 取决 于 资源 | 只 读 " 指定 范围 的 步 长 值 
Precision | 精度 取决 于 资源 数字 取决 于 资源 | 只 读 否 值 的 精度 

















对 于 本 质 上 具有 多 个 物理 参数 的 资源 ,可 以 用 指定 不 同 物理 参数 的 多 个 属性 替换 。 值 的 类 型 应 在 
资源 类 型 的 RAML 定义 中 指示 ,并 且 应 适用 于 所 传递 的 值 。 所 有 属性 名 称 和 属性 值 区 分 大 小 写 。 

3. 基本 资源 模式 

本 节 定 义 的 所 有 资源 类 型 表示 由 JSON 模式 指出 。 资 源 类 型 RAML 定义 嵌入 到 资源 类 型 特定 的 
模式 元 素 中 。 可 以 根据 资源 类 型 定义 和 人 允许 的 CRUDN 操作 创建 或 更 新 资源 。 该 操作 具有 不 同 含义 的 
响应 代码 ,如 表 11-4 所 示 。 





表 11-4 响应 代码 及 含义 


响应 代码 = x 

200 响应 的 有 效 载荷 将 确认 更 改 ,RAML 定义 将 包含 一 个 模式 来 定义 有 效 负 载 

201 有 效 负载 是 由 于 创建 操作 而 由 服务 器 端 创建 资源 的 URL。RAML 定义 将 包含 定义 有 效 负 载 的 模式 
一 切 顺利 ,没有 提供 有 效 载荷 ,RAML 定义 不 包含 模式 ; RAML 定义 可 以 省 略 此 值 ,因为 它 被 认为 是 OCF 
服务 器 端的 默认 行为 
情况 1: 在 使 用 查询 参数 选择 特定 属性 值 资源 上 检索 的 情况 下 ; 如 果 服 务 器 端 不 支持 提供 的 值 , 则 应 返回 
此 响应 。 响 应 有 效 内 容 应 包含 查询 参数 的 允许 值 
情况 2: 由 于 提供 的 有 效 负载 问题 ,服务 器 端 无 法 创建 或 更 新 资源 。 对 于 更 新 ,除非 在 资源 类 型 定义 中 另 
有 说 明 ,响应 有 效 载荷 应 包括 为 200 定义 的 相同 模式 ; 指示 当前 资源 属性 值 











204 





403 





11.1.3. 示例 资源 定义 


本 节 包 括 代 表 执 行 器 资源 的 RAML 示例 和 执行 传感器 资源 的 RAML 示例 。 
1. 代表 执行 器 资源 的 RAML 示例 


# * RAML 0.8 title: 
OICExampleActuator 
version: v1.0 
/ActuatorExample: 
description: | 
ResourceActuatorExample description. 
If the ActuatorExample is implemented as the example in the RAML the next values apply: The name of the 
Resource is "ResourceExample Name" 
The Resource Type is "oic.r.actuatorexample" 
The Interface (if) is denoting an Actuator by having the value oic. if.a. 
The unique identification is "actuator example id" 
The value of the ActuatorExample is modeled as integer 
The range of the value of ActuatorExample is between 0 and 100 
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get: 
description: | 
retrieves the example Resource. 
responses: 
200: 
body: 
application/json: 
schema: | 
{ 
"id": "http: //openinterconnect. org/schemas/oic. r. actuatorexample. json", " $ schema" : 
"http: //json- schema. org/draft — 04/schema # ", 
"title": "AcutatorExample", 
"definitions": ( 
"oic.r.actuatorexample: ( 
"type": "object", 
"properties": ( 
"value": ( "type": "string" }, 





"integer" 
} 
} 
} 
} 
} 
"type": "object", 
"allof": [ 
{" $ ref": "oic. core. json# /def initions/oic.core"], 
{" $ ref": oic. baseResource. json # /definitions/oic. r. baseresource"}, 
{" $ ref": "+ /definitions/oic. r. actuatorexample" } 
l 
"required": ["value"] 
) 
example: | 
{ 
"i": "ActuatorExample Name", 
"id": "actuator example id", 
"rt": — ["oic.r.actuatorexample"], 
"value": "0", 
"range": ["0,100"] 
) 
post: 
description: | 


sets the Actuator value 
example only updates the value of the Resource 
it does not change the Resource name, although it is allowed to do so. 


body: 
applicaton/json: 
schema: | 
{ 
"id": "http://openinterconnect. org/schemas/oic. r. actuatorexample. json", 


" $ schema": "http: //json— schema. org/draft - 04/schema#", 
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"title": "AcutatorExample", 
"definitions": ( 
"oic.r.actuatorexample" : { 
"type": "object", 
"properties": ( 
"value": ( "type": "string" }, 








(" $ ref": "oic. core. json# /definitions/oic.core"}, 
(" $ ref": "oic. baseResource. json /definitions/oic. r. baseresource"}, 
(" $ ref": "#/definitions/oic. r. actuatorexample" } 

1, 

"required": ["value"] 

} 
example: | 
{ 
"id": "actuator example id", 
"value" : 5 


) 
responses: 
200: 
body: 
application/json: 
schema: | 
{ 
"id": "http: //openinterconnect. org/schemas/oic. r. actuatorexample. json", 
" $ schema": "http: //json - schema. org/draft - 04/schema#", 
"title": "AcutatorExample", 
"definitions": { 
"oic.r.actuatorexample": { 
"type": "object", 
"properties": ( 
"value": ( "type": "string" }, 
"range": ( 
"type": "array", 
"items": { 
"type" :" integer" 
) 
) 
) 
) 
Lh 
"type": "object", 
"allof":[ 


(" $ ref": "oic. core. json# /definitions/oic. core"}, 
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(" $ ref": "oic. baseResource. json# /def initions/oic. r. baseresource"}, 
{" $ ref": " & /definitions/oic.r.actuatorexample"] 
L 
"required" : 
} 
example: | 


{ 





"value" ] 


"id": "actuator example id", 
"value": 5 


204: 
2. 指定 传感器 资源 的 RAML 示例 


# % RAML 0.8 
title: OICExampleSensor 
version: v1.0 
/SensorExample: 
description: | 
SensorExample description. 
If the SensorExample is implemented as the example in the RAML the next values apply: 
The name of the Resource is "ResourceExample_Name" 
The Resource Type is "oic.r.sensorexample" 
The Interface (if) is denoting a Sensor by having the value oic. if. s. 
The unique identification is "sensor example id" 
The value of the ResourceSensorExample is modeled as integer 
get: 
description: | 
retrieves the example Resource. 
responses: 
200: 
body: 
application/json: 
schema: | 
{ 
"id": "http://openinterconnect. org/schemas/oic. r. sensorexample. json", 
" $ schema": "http: //json- schema. org/draft - 04/schema#", 
"title": "SensorExample", 
"definitions": ( 
"oic.r.sensorexample": ( 
"type": "object", 
"properties": ( 
"value": ( "type": "string" ), 
"range": { 
"type": "array", 
"items": { 
"type": "integer" 





: "object", 


ES i 
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(" $ ref": "oic. core. json# /definitions/oic.core"], 

(" $ ref": "oic. baseResource. json# /def initions/oic. r. baseresource"], 

(" $ ref": " & /definitions/oic. r. sensorexample"}, 
L 
"required": ["value"] 
} 


example: | 
{ 
"p": "SensorExample Name", 
"xt": ["oic. r. sensorexample"], 
wid": "sensor example id", 
"value": "3" ) 


11.1.4. 可 观察 的 资源 类 型 


OCF 核心 规范 定义 了 一 种 机 制 ,通过 该 机 制 ,资源 可 以 将 自己 作为 “可 观察 ”通告 给 OCF 客户 端 。 
在 本 部 分 中 定义 的 所 有 资源 类 型 可 被 观察 到 。 通 过 使 用 策略 链 路 参数 ,使 资源 类 型 可 否 观察 ,是 完全 依 
赖 于 实现 的 ,也 就 是 有 条 件 通知 。 

所 有 可 观察 资源 都 可 以 申请 一 种 条 件 , 由 于 某 种 观察 动作 而 产生 通知 ,这 些 条 件 可 以 是 基于 时 间 
的 、 基 于 值 的 或 者 基于 值 和 时 间 的 。 这 是 由 条 件 通 知 (“oic. r. value. conditional”) 资 源 类 型 和 一 个 可 观 
察 资源 实例 构成 的 ,是 由 拥有 [“oic. r. < resource >. oic. r. value. conditional”] 的 “rt”" 服 务 器 端 暴 露出 的 
资源 。 

1. 条 件 通知 属性 概要 

表 11-5 所 示 的 条 件 通 知 属性 概括 了 条 件 通 知 资源 类 型 的 多 个 属性 ,资源 类 型 实例 中 至 少 要 有 一 个 











来 源 于 该 表格 的 属性 。 
表 11-5 条 件 通知 属性 
名 »* 类 型 操作 是 否 强制 描 述 
BIA 数值 读 写 a 在 通知 产生 之 前 观察 值 变化 量 
最 小 通知 间隔 整 型 读 写 5 通知 发 送 之 前 经 过 的 最 短 时 间 
最 大 通知 间隔 整 型 读 写 a 通知 发 送 之 前 经 过 的 最 长 时 间 














所 有 属性 一 旦 被 暴露 , 则 必须 被 设置 初始 值 。 所 有 属性 都 可 以 0 值 暴 露 ,这 表明 该 属性 的 功能 没有 
被 激活 。 任 意 客 户 端 可 以 将 被 暴露 的 值 更 新 至 任意 访问 控制 列表 ,这 种 改变 是 全 局 的 ,而 且 会 产生 通知 
发 送 给 所 有 观察 者 。 通 知 者 可 以 拒绝 对 属性 值 的 更 新 ,在 这 种 情况 下 .诊断 有 效 载荷 应 该 包含 在 拒绝 响 
应 中 ,去 指示 该 值 的 有 效 范围 。 

2. 属性 定义 : 阅 值 

阔 值 指 两 个 通知 之 间 的 最 小 值 更 改 。 当 自 上 次 通知 以 来 的 更 改 大 于 或 等 于 此 值 时 ,应 发 送 通 知 ( 在 
最 小 通知 间隔 的 限制 内 )。 测 量 是 针对 发 送 最 后 一 个 通知 中 的 值 进行 .因此 .所 有 通知 (在 可 能 存在 的 任 
何 最 大 通知 间隔 约束 内 ) 将 携带 至 少 阔 值 的 值 。 属 性 值 为 0, 表示 不 应 用 阔 值 。 

3. 属性 定义 : 最 小 通知 间隔 

最 小 通知 间隔 指 在 通知 之 间 发 生 的 最 短 时 间 ( 以 毫秒 为 单位 ) 。 如 果 满 足 值 变更 条 件 ( 阔 值 等 于 o 
过 ,不 存在 则 值 变 化 ) ,到 期 前 不 得 发 送 通 知 , 直 到 期 限 届满 为 止 。 如 果 属 性 存在 并 设置 为 0, 则 不 运行 
最 小 通知 间隔 计时 器 ; 如 果 属 性 存在 并 且 值 大 于 0, 那 么 最 小 通知 周期 定时 器 应 该 等 于 该 值 。 属 性 值 本 
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身 最 初 由 通知 程序 填充 。 如 果 属 性 不 存在 , 则 最 小 通知 期 间 由 通知 者 决定 。 每 次 发 送 通知 时 ,计时 器 都 
将 被 复位 。 

4. 属性 定义 : 最 大 通知 间隔 

最 大 通知 间隔 指 在 通知 之 间 通 知 器 不 得 超过 的 最 长 时 间 ( 以 毫秒 为 单位 )。 当 计时 器 到 期 时 ,应 发 
送 通知 。 如 果 属 性 存在 并 设置 为 0, 则 不 运行 最 大 通知 间隔 计时 器 ; 如 果 属 性 存在 且 值 大 于 0, 则 最 大 
通知 间隔 计时 器 应 该 等 于 该 值 。 属 性 值 本 身 最 初 由 通知 器 填充 。 当 最 小 通知 间隔 和 最 大 通知 间隔 都 存 
在 ,并 且 都 不 为 零 时 ,最 大 通知 间隔 的 值 应 大 于 最 小 通知 间隔 。 如 果 属 性 不 存在 ,该 值 应 由 通知 器 设置 。 
每 次 发 送 通知 时 ,计时 器 都 将 被 复位 。 

5. 管理 状态 机 

最 小 通知 间隔 和 最 大 通知 间隔 计时 器 在 通知 被 发 送 后 都 会 复位 。 当 条 件 ( 阔 值 ) 和 最 小 通知 间隔 都 
满足 时 ,通知 将 会 被 发 送 。 如 果 观 察 到 的 属性 值 随 后 在 最 小 通知 间隔 到 期 之 前 落 在 靖 值 之 下 , 则 通知 人 
可 能 不 采取 任何 行动 ,或 者 在 包含 当前 观察 到 的 属性 值 (在 通知 时 ) 的 最 小 通知 间隔 到 期 时 ,可 以 发 送 通 
知 。 如 果 没有 计时 器 限制 ,那么 只 要 观察 到 的 属性 值 改 变 了 大 于 或 等 于 阔 值 的 量 ,就 会 发 送 通知 。 

总 体 条 件 通知 逻辑 定义 如 图 11-1 所 示 , 条 件 通知 示例 流程 提供 了 一 个 说 明 性 的 顺序 ,代码 表示 
如 下 : 


















































观察 者 WDR 
初始 化 
观察 请 求 
观察 者 请 求 确认 ， 开 启 计 时 器 d 
TRAC 
新 的 值 = 值 + 辣 值 d 
最 小 通知 间隔 到 其 
通知 新 的 值 
被 观察 者 改变 的 值 超过 国 值 ， 最 小 通知 间隔 到 
期 发 送 一 个 通知 。 计 时 器 复位 
新 的 值 = 值 + 小 于 国 值 4 
最 大 通知 间隔 到 期 
通知 新 的 值 





被 观察 者 改变 的 值 小 于 国 值 。 到 最 大 通知 
间隔 到 期 才 有 通知 被 发 送 。 计 时 器 复位 














图 11-1 条 件 通知 示例 流程 
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If minnotifyperiod expired: 
1f observed value changed: 
If change amount > = threshold: 
Send notification with current value 
Reset ninnotifyperiod , maxnotifyperiod 
If maxnotifyperiod expired: 
Get current value 
Send notification with current value 
Reset minnotifyperiod, maxnotifyperiod 


11.1.5 复合 资源 类 型 


复合 资源 类 型 是 由 一 个 或 多 个 单一 或 其 他 复合 资源 类 型 组 成 的 资源 ,如 下 文 的 RAML 定义 所 示 。 
可 以 将 复合 资源 类 型 视 为 新 的 单个 资源 类 型 。 复 合资 源 型 机 制 是 一 个 强大 的 概念 ,因为 它 使 用 现 有 的 
资源 类 型 形成 一 个 新 的 组 合 ,表达 更 多 的 上 下 文 资源 ,而 不 指定 新 的 单一 资源 类 型 。 

通过 引用 现 有 资源 值 链接 到 集合 的 方法 ,定义 复合 资源 类 型 。 链 接 是 通过 使 用 “Links” 的 数组 来 完 
成 的 ; 有 关 更 多 详细 信息 ,请 参阅 核心 规范 ( 见 第 3 章 资 源 表示 )。 请 注意 ,下 面 列 出 的 示例 ,包含 定义 
部 分 的 模式 , 仅 用 于 描述 目的 。 数 组 的 属性 名 称 是 链接 。 关 系 型 应 为 包含 ,表示 该 复合 资源 含有 其 他 资 
源 类 型 构成 综合 资源 类 型 。 所 列 出 的 资源 访问 可 以 在 单个 操作 中 ,通过 使 用 OCF 核心 规范 定义 *oic. 让 1” 
接口 来 实现 。 符 合 本 部 分 规范 的 设备 应 将 字符 串 "res. 1. 1. 0" 添 加 到 *oic. wk. d” 中 的 “dmv” 属 性 中 。 

复合 资源 的 RAML 示例 如 下 : 





# % RAML 0.8 
title: OICExampleCompositeResource 
version: v1.0 
/CompositeExample: 
description: | 
CompositeExample description. 
If the CompositeExample is implemented as per the example RAML the following values apply: 
The name of the Resource is "CompositeExample Name" 
The Resource Type is "oic. r. compositeexample" 
The Interface (if) can denote Sensor or Actuator 
The value of the ActuatorExample is modeled as 2 references to other implemented Resources 
In the example oic. r. SensorExample and oic. r. ActuatorExample are used. 
get: 
description: | 
retrieves the composite example Resource. 
responses: 
200: 
body: 
application/json: 
schema: | 
{ 
"id": "http://openinterconnect. org/schemas/oic. r. baseResource +", 
" $ schema": "http: //json— schema. org/schema#", 
"title": "SensorExample", 
"definitions": { 
"oic.r.compositeexample": { 
"type": "object", 
"properties": { 
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": "oic. core. json# /definitions/oic.core"}, 
(" $ ref": "oic. baseResource. json# /definitions/oic. r. baseresource"], 
(" $ ref": " & /definitions/oic. r. compositeexample"] 


required": ["n", "id", "links"] 


"n": "ConpositeExample Name", 
"id": "composite example id", 
"links": [ 
t 
"href": "/my 1st reference", 
"rel": "contains", 
"rt": ["oic.r.actuatorexample"], 
"if": ["odc. i£.a"] 


} 
{ 


"href": "/my_2nd_reference", 
"rel": "contains", 

"rt": ["oic. r. sensorexample" ], 
"if": ["oic. if.s"] 


11.1.6 基础 资源 
基础 资源 模式 是 所 有 其 他 资源 构建 的 基础 。URI 示例 为 "/BaseResourceSchemaResURI"” ,资源 类 


型 为 “oic. baseresource”。 


1. RAML 定义 


# * RAML 0.8 
title: OICBaseResourceSchema 
version: v1.1.0 - 20160519 
traits: 
- interface- a : 
queryParameters: 
if: 
enum: ["oic. if.a"] 
- interface- baseline : 
queryParameters: 
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if: 
enum: ["oic. if. baseline" ] 
/BaseResourceSchemaResURI : 
description: | 
This is the base resource schema in which all other resources defined in this specification build 
get: 
description: | 
retrieves the state of the resource. 
responses : 
200: 
body: 
application/json: 
schema: | 
{ 
vid: 
"http: //openinterconnect. org/ iotdatamodels/schemas/oic. basecorecomposite. json & ", " $ schema": "http:// 
json - schema. org/draft - 04/schema & ", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved. ", 
"title": "Base and Core Composite Resource", 
"definitions": ( 
"oic.core": ( 
"properties": ( 





"ri": d 
"type": "array", 
"items" : [ 
{ 
"type" : "string", 
"naxLength": 64 
) 
1, 
"ninItems" : 
"description": "ReadOnly, Resource Type" 
}, 
"dE: | 


"type" : "array", 
"description": "ReadOnly, The interface set supported by this resource", 
"items": ( 
"type": "string", 
"enun" : ["oic. if. baseline", "oic. if.ll", "oic. if.b", "oic.if.lb", 9703 
"oic. if.rw", "oic. if.r", "oic.if.a", "oic. if.s" ] 








} 
)h 
"vd 
"type": "string", 
"description": "ReadOnly, Friendly name of the resource" 9709 
n 
"id": ( 


"type": "string" 
"description": "ReadOnly, Instance ID of this specific resource" 
) 
) 
Lh 
"oic.r.baseresource": ( 
"properties": ( 
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("type" 
"type" 
"type" 
("type" 
{"type" 
l 





"type": 
"description": "The valid range for the value Property", 
"minItems": 2, 
$2, 





) 
i 
) 
) 
"type": "object", 
"allof": [ 


(" $ ref": " & definitions/oic.core"], 
(" $ ref": " # /def initions/oic.r. baseresource"] 


] 
) 
example: | 
{ 
"rt" ["oic. baseresource" ], 
"if": ["oic. if. baseline"], 
Tig: "unique example id", 
"value": "soneValue", 
"range" : [0,100] 
} 
post: 
description: | 
sets the read - write resource properties 
body: 
application/json: 
schema: | 


t 
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"id": " http://openinterconnect. org/iotdatamodels/schemas/oic. baseResource. json #", " 


$ schema": "http://json- schema. org/draft — 04/schema # ", 


"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights 


reserved. ", 
"title": "Base Resource", 
"definitions": ( 
"oic. r. baseresource" : ( 
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"type": "object", 
"properties": ( 
"value": ( 
"anyOf" : 
("type" : 
{"type": 
(" type" 
(" type" 
("type" : 
("type" : 
L 
"description": "The value sensed or actuated by this Resource" 
}, 
"range": { 
"type": "array", 
"description": "The valid range for the value Property", 
"minItems": 2, 
"maxItems": 2, 
"items": { 
"anyof": [ 
("type" : "number"}, 
("type" : " integer") 













] 
} 
} 
} 
} 

Lh 
"type": "object", 
"allof":[ 


(" $ ref": "oic. core. json# /definitions/oic.core"], 
(" $ ref": " & /def initions/oic. r. baseresource"] 
] 
example: | 
{ 
"value": "newValue" 
) 
responses : 
200: 
body: 
application/json: 
schema: | 
{ 


"id": "http: //openinterconnect. org/ iotdatamodels/schemas/oic. baseResource. json # ", 
$ schema": "http://json- schema. org/draft - 04/schema +", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved.", 
"title": "Base Resource", 
"definitions": ( 
"oic.r.baseresource": { 
"type": "object", 
"properties": ( 
"value": { 


"anyof": [ 
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("type" : "array"}, 

("type": "string"}, 

(" type": "boolean"], 

("type": "integer"], 

(" type" : "nunber"], 

(" type" : "object"} 
L 


"description": "The value sensed or actuated by this Resource" 


: "array", 
"description": "The valid range for the value Property", 
"minItems": 2, 
"maxItems" : 2, 
"items": { 
"anyof": [ 
{"type": "number"}, 
{"type": "integer"} 


) 

"type": "object", 

"allof": [ 
{"$ ref": "oic. core. json# /definitions/oic. core"}, 
(" $ ref": "#/definitions/oic. r. baseresource"] 






































] 
} 
example: | 
{ 
"value": "newValue" 
} 
2. 属性 定义 
属性 定义 如 表 11-6 所 示 。 
表 11-6 属性 定义 
m o 名 属性 值 类 型 访问 模式 说 明 
rt 数组 资源 类 型 
maxLength 整 型 最 大 长 度 
if 数组 RE 该 资源 支持 的 接口 
n 字符 串 只 读 资源 的 友好 名 称 
id 字符 串 Ri 此 特定 资源 的 实例 ID 
value 多 类 型 
range 数组 读 写 value 属性 的 有 效 范围 
3. CRUDN 行为 


CRUDN 行为 如 表 11-7 所 示 。 





272 || OCF 技 术 原理 及 物 联网 程序 开发 指南 


表 11-7 CRUDN 行为 





资 源 


创建 检索 更 新 


删除 


通知 





/BaseResourceSchemaResURI 











get post 








get 





11.2 资源 类 型 定义 概述 


本 节 介 绍 目前 OCF 所 有 资源 类 型 的 定义 ,如 表 11-8 所 示 , 按 字母 顺序 排列 的 资源 类 型 列 出 了 完 








































































































整 集 。 
RUS 按 字母 顺序 的 资源 类 型 列表 
友好 名 称 ( 非 正式 ) 资 源 类 型 注 o OR 
Acceleration Sensor oic. r. sensor. acceleration 加 速 传感器 
Activity Count oic. r. sensor. activity. count 行为 计数 
Air Quality oic. r. airquality 空气 质量 
Air Quality Collection oic. r airqualitycollection 空气 质量 集合 
Altimeter oic. r. altimeter 高 度 计 
Atmospheric Pressure oic. r. sensor. atmosphericpressure 气压 
Air Flow airflow 气流 
Air Flow Control oic. r, airflowcontrol 气流 控制 
Audio Controls audio 音频 控制 
Auto Focus oic. r. autofocus 自动 对 焦 
Automatic Document Feeder oic. r automaticdocumentfeeder 自动 文档 输送 
Auto White Balance oic. r. colour. autowhitebalance 自动 白 平 衡 
Basic Resource Schema Not Applicable 基础 资源 模式 
Battery oic. r. energy. battery 电池 
Binary Switch oic. r. switch. binary 二 进 制 开 关 
Brightness oic. r. light. brightness JE HE 
Button Switch oic. r. button 按钮 开关 
Carbon Dioxide Sensor oic. r. sensor. carbondioxide 二 氧化 碳 传感器 
Carbon Monoxide Sensor sensor. carbonmonoxide 一 氧化 碳 传感器 
Clock oic. r. clock 时 钟 
Colour Chroma oic. r. colour. chroma 颜色 的 色 度 
Colour RGB oic. r. colour. rgb 颜色 的 RGB 
Colour Saturation oic. r. colour. saturation 颜色 的 饱和 度 
Consumable oic. r. consumable 耗材 
Consumable Collection oic. r. consumablecollection 耗材 集合 
Contact Sensor oic. r. sensor. contact 接触 传感器 
Delay Defrost oic. r. delaydefrost RA 
Demand Response Load Control (DRLC) | oic. r. energy. drlc 需求 响应 负荷 控制 
Dimming oic. r. light. dimming 调整 亮度 
Door . door 门 
Ecomode . ecomode 节能 模式 







































































































































































d 

友好 名 称 ( 非 正式 ) 资 源 类 型 t # 
Energy Consumption oic. r. energy. consumption 能 耗 
Energy Overload/ Circuit Breaker oic. r, energy. overload 能 耗 过 载 制 动 
Energy Usage oic. r. energy. usage 能 耗 使 用 
Generic Sensor oic. r, sensor 通用 传感器 
Geolocation Sensor oic. r. sensor. geolocation 位 置 传感器 
Glass Break Sensor oic. r. sensor. glassbreak 玻璃 破碎 传感器 
Heart Rate Zone Sensor oic. r. sensor. heart. zone 心率 传感器 
Heating Zone oic. r. heatingzone 加 热 区 
Heating Zone Collection oic. r. heatingzonecollection 加 热 区 集合 
Height oic. r. height 高 度 
Humidity oic. r. humidity 湿度 
Icemaker oic. r. icemaker 制 冰 
Illuminance Sensor oic. r. sensor. illuminance 照度 传感器 
Lock oic. r. lock. status Bi 
Lock Code oic. r. lock. code 锁 密 码 
Magnetic Field Direction oic. r. sensor. magneticfielddirection 磁场 方向 
Media oic. r. media 媒体 
Media Source oic. r. media. source 媒体 源 
Media Source List oic. r. mediasourcelist 媒体 源 列表 
Media Source Input oic. r. media. input 媒体 源 输入 
Media Source Output oic. r. media. output 媒体 源 输出 
Mode oic. r. mode 模式 
Movement oic. r. movement. linear 移动 
Motion Sensor oic. r. sensor. motion 运动 传感器 
Night Mode oic. r. nightmode 夜间 模式 
Open Level oic. r. openlevel 打开 程度 
Operational State oic. r. operational. state 操作 状态 
Pan Tilt Zoom Movement oic. r. ptz 平移 变焦 运动 
Presence Sensor oic. r. sensor. presence 出 现 传感器 
Ramp Time oic. r. light. ramptime 斜 升 时 间 
Refrigeration oic. r. refrigeration 冷冻 
Selectable Levels oic. r. selectablelevels 可 选 等 级 
Signal Strength oic. r. signalstrength 信号 强度 
Sleep Sensor oic. r. sensor. sleep 睡眠 传感器 
Smoke Sensor oic. r. sensor. smoke 烟雾 传感器 
Speech Synthesis oic. r. speech. tts 语音 合成 
Temperature oic. r. temperature 温度 
Three Axis Sensor oic. r. sensor. threeaxis 三 轴 传感器 
Time Period oic. r. time. period 时 段 
Touch Sensor oic. r. sensor. touch 接触 传感器 
UV Radiation oic. r. sensor. radiation. uv 紫外 辐射 
Value Conditional oic. r. value. conditional 条 件 值 
Water Sensor oic. r. sensor. water 水 传感器 
Weight oic. r. weight 重量 
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所 有 资源 类 型 应 根据 OCF 核心 规范 ,在 本 书 第 3 章 创建 ,所 有 与 资源 类 型 的 比较 都 不 区 分 大 小 
写 。 所 有 资源 类 型 都 以 *oic. r" 作 为 前 级. 表示 它 是 OCF 定义 的 资源 类 型 ,本 章 将 依次 介绍 每 个 资源 
的 定义 。 


11.3 应 用 资源 类 型 举例 


本 节 以 气流 为 例 ,对 应 用 资源 的 定义 ,操作 等 进行 描述 ,其 他 应 用 资源 请 参阅 OCF 规范 文档 ,在 此 
不 再 一 一 次 述 。 

气流 资源 描述 与 空气 流 相 关 的 属性 。 方 向 是 气流 的 方向 性 (如 果 适 用 )。 方 向 值 取决 于 该 单元 的 功 
能 。 速 度 是 表示 本 机 当前 速度 水 平 的 整数 。 范 围 是 代表 速度 值 的 最 小 值 . 最 大 值 的 数组 。 如 果 没有 出 
现 , 则 默认 值 为 Lo,100]。 可 以 存在 自动 模式 ,打开 的 时 候 , 速 度 由 设备 自动 控制 。URI 示例 为 
“/AirFlowResURI” ,资源 类 型 为 “oic. r. airflow”. 

1. RAML 定义 


# * RAML 0.8 
title: OICAirFlow 
version: v1.1.0 - 20160519 
traits: 
- interface : 
queryParameters: 
if: 
enum: ["oic. if.a", "oic. if. baseline" ] 
/ AirFlowResURI: 
description: | 
This resource describes the properties associated with air flow. 
The direction is the directionality of the air flow if applicable. 
Direction values are dependent on the capabilities of the unit. 
The speed is an integer representing the current speed level for the unit. 
The range is an array of the min, max values for the speed level. 
is : ['interface'] 
get: 
description: | 
Retrieves the current air flow values. 
responses : 
200: 
body: 
application/json: 
schema: | 
t 
"id": "http://openinterconnect. org/iotdatamodels/schemas/oic. r.airFlow. json#", 
" $ schema": "http: //json— schema. org/draft - 04/schema#", 
"description" : ""Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved.", 
"title": "Air Flow", 
"definitions": { 
"oic.r.airflow": { 
"type": "object", 
"properties": ( 
"direction": ( 
"type": "string", 
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"description": "Directionality of the air flow" 


"type": "integer", 
"description": "Current speed level" 








range 
"type": "array", 
"description": "ReadOnly, Min,max values for the speed level", 
"items": ( 
"type": "integer" 
) 
) 
) 
} 
Lh 
"type" : "object", 
"allof":[ 


(" $ ref": "oic. core. json# /def initions/oic.core"], 
(" $ ref": "oic. baseResource. json & /def initions/oic. r. baseresource"), 


(" $ ref": " & /def initions/oic.r.airflow"] 


L 
"required": ["speed"] 

) 

exanple: | 

{ 
"uti ["oic. r. airflow"], 
"id": "unique example id", 
"direction": "left", 
"speed" : 5, 
"range" : 1,7] 

} 

post: 
description: | 


Sets the current air flow values. 
Only direction and speed may be set by an update operation. 
body: 
application/json: 
schema: | 
{ 
"id": "http: //openinterconnect. org/ iotdatamodels/schemas/oic. r. airFlow. json#", " $ schema": " 
http: //json— schema. org/draft - 04/schena#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved.", 
"title": "Air Flow", 
"definitions": ( 
"oic.r.airflow": { 
"type": "object", 
"properties": ( 
"direction": ( 
"type": "string", 
"description": "Directionality of the air flow" 
Lh 
"speed": ( 
"type": "integer", 
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"description": "Current speed level" 
Lh 
"ange": d 
"type": "array", 
"description": "ReadOnly, Min,max values for the speed level", 
"items": ( 
"type": "integer" 





: "object", 

"allof": [ 
(" $ ref": "oic. core. json# /def initions/oic.core"], 
(" $ ref": "oic. baseResource. json# /def initions/oic. r. baseresource"], 
(" $ ref": " & /definitions/oic. r.airflow"] 


L 
"required": ["speed" ] 
) 
example: | 
t 
vid"; "unique example id", 
"direction": "right", 
"speed" : 3 
) 
responses : 
200: 
body: 
application/json: 
schema: | 


{ 
"id": "http: //openinterconnect. org/iotdatamodels/schemas/oic. r. airFlow. json #", " 
$ schema": "http: //json- schema. org/draft - 04/schema +", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights reserved.", 
"title": "Air Flow", 
"definitions": { 
"oic.r. airflow": { 
"type": "object", 
"properties": { 
"direction": { 
"type": "string", 
"description": "Directionality of the air flow" 


: "integer", 





: "array", 
"description": "ReadOnly, Min, max values for the speed level", 
"items": { 
"type": "integer" 
) 
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} 
; 
} 
Ln 
"type": "object", 
"allof":[ 
(" $ ref": "oic. core. json# /def initions/oic.core"], 
(" $ ref": "oic. baseResource. json & /definitions/oic. r. baseresource"}, 
(" $ ref": " & /definitions/oic.r.airflow"] 
L 
"required": ["speed"] 
} 


example: | 
{ 
pet i "unique example id", 
"direction": "right", 
"speed" : 3 
) 
403: 
description: | 
This response is generated by the OIC Server when the client sends: 
An update with an invalid property value for direction. 
An update with an out of range property value for speed. 
The server responds with the current resource representation. 
body: 
application/json: 
schema: | 
{ 
"id": "http: //openinterconnect. org/iotdatamodels/schemas/oic. r.airFlow. json#", 
" $ schema": "http: //json - schema. org/draft - 04/schema#", 
"description" : "Copyright (c) 2016 Open Connectivity Foundation, Inc. All rights 
reserved.", 


"title": "Air Flow", 
"definitions": { 
"oic.r.airflow": { 
"type": "object", 
"properties": { 
"direction": { 
"type": "string", 
"description": "Directionality of the air flow" 
) 
"speed": ( 
"type": "integer", 
"description": "Current speed level" 
h 





"description": "ReadOnly, Min,max values for the speed level", 
"items": ( 

"type": "integer" 
} 





} 
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B 


"type": "object", 


























"allot": [ 
(" $ ref": "oic. core. json# /definitions/oic.core"], 
(" $ ref": "oic. baseResource. json # /definitions/oic. r. baseresource"}, 
(" $ ref": " & /definitions/oic.r.airflow"] 
L 
"required": ["speed"] 
} 
example: | 
{ 
"id": "unique example id", 
"direction": "right", 
"speed" : 3 
) 
2. 属性 定义 
属性 定义 如 表 11-9 所 示 。 
表 11-9 属性 定义 
属 性 名 属性 值 类 型 是 否 强制 访问 模式 说 明 
direction 字符 串 读 写 空气 流 的 方向 性 
speed 整 型 是 读 写 目前 的 速度 等 级 
range 数组 读 写 速度 等 级 的 最 大 、 最 小 值 
3. CRUDN 行为 
CRUDN 行为 如 表 11-10 所 示 。 
表 11-10 CRUDN 行为 
资 源 创建 检索 更 新 删除 通知 
/AirFlowResURI get post get 
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CHAPTER 12 








本 章 主要 介绍 OCF 的 具体 开发 方法 ,包括 基于 Mac, Windows, Linux, Android 和 Arduino 开发 的 
方法 ,从 软件 工具 、 编 译 方法 .实例 代码 到 综合 案例 进行 描述 。 


12.1 基于 Mac 的 开发 方法 

本 节 主 要 包括 Mac OSX 环境 下 的 编译 方法 .APP 实例 和 实例 代码 。 

12.1.1 Mac OSX 环境 下 的 编译 方法 

OD 为 了 能 够 在 Mac OSX 环境 下 编译 代码 ,需要 安装 Xcode, 其 下 载 地 址 为 https: //developer 
. apple. com/ xcode/downloads/ 。 

(2) 在 Mac 命令 行 下 执行 : 


$ cd < top directory of the project > 
$ scons SYS_VERSION = yyy 


其 中 ,yyy 是 OSX 的 版 本 号 ,例如 10. 10。 
(3) 运行 编译 成 功 的 示例 程序 ,首先 要 在 命令 行 执 行 以 下 指令 : 


export DYLD LIBRARY PATH= < iotivity root >/out/darwin/x86_64/release 


12.1.2 APP 实例 

该 实例 描述 基本 的 服务 器 端 和 客户 端 ,展示 基本 的 资源 发 现 过 程 和 资源 操作 。 

CD. 编译 程序 成 功 后 ,分别 生成 执行 文件 ocservercoll 和 occlientcoll, 如 图 12-1 和 图 12-2 所 示 。 
(2) 从 图 12-1 中 可 以 看 到 ,服务 器 端 启动 后 创建 了 fan \light 和 room 三 个 资源 。 

(3) 客户 端 启动 后 ,发现 服务 器 端 创建 的 资源 和 已 经 存在 的 资源 ,并 对 资源 进行 操作 ,如 图 12-3 和 


图 12-4 所 示 。 
12.1.3 实例 代码 
本 节 包 插 两 部 分 代码 : 服务 器 端 (ocservercoll. cpp) 和 客户 端 (occlientcoll. cpp) 。 
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occlient.o occlientslow.o ocservercoll.o 

occlientbasicops ocserver ocservers low 

occlientbasicops.o ocserver.o ocserverslow.o 

occlientcoll ocserverbasicops 

liyonghuadeMacBook-Pro:SimpleClientServer liyonghua$ ./ocservercoll 
ocservercontainer: Usage : ocservercoll -t «Test Case» 

16:22.942392000 INF ocservercontainer: Test Case 1 : Create room resource with 

default collection entity handler. 

16:22.942396000 INFO: ocservercontainer: Test Case 2 : Create room resource with 

application collection entity handler. 

liyonghuadeMacBook-Pro:SimpleClientServer liyonghua$ ./ocservercoll -t 1 

18:36.180022000 ocservercontainer: OCServer is starting... 

18:36.181041000 ocservercontainer: Created fan resource with result: OC_ST 

ACK_OK 

18:36.181051000 : ocservercontainer: Created light resource with result: OC. 

STACK_OK 

18:36.181057000 : ocservercontainer: Created room resource with result: OC_S 

TACK, OK 

18:36.181062000 ocservercontainer: OC Bind Contained Resource to resourc 

OC, STACK, OK 

18:36.181065000 : ocservercontainer: OC Bind Contained Resource to resource: 

OC. STACK, OK 

18:36.181085000 : ocservercontainer: Entering ocserver main loop 





图 12-1 JÄ 3h ocservercoll 


liyonghuadeMacBook-Pro:SimpleClientServer liyonghua$ ./occlientcoll G] 
17:28.26580000 INFO: occlient: Usage : occlientcoll -t «Test Case» -c «CA connec 
tivity Type» 
17:28.26615000 INFO: occlient: -c 0 : Default auto-selection 
8.26618000 INFO: occlient: -c 1 : IP Connectivity Type 

:28.26621000 INFO: occlient: Test Case 1 : Discover Resources && Initiate 
Request on an available resource using default interface. 
17:28.26624000 INFO: occlient: Test Case 2 : Discover Resources && Initiate 
Request on an available resource using batch interface. 
17:28.26626000 INFO: occlient: Test Case 3 : Discover Resources && Initiate 
Request on an available resource using link list interface. 
17:28.26629000 INFO: occlient: Test Case 4 : Discover Resources && Initiate 
& PUT Request on an available resource using default interface. 
17:28.26635000 INFO: occlient: Test Case 5 : Discover Resources && Initiate 
& PUT Request on an available resource using batch interface. 
17:28.26638000 INFO: occlient: Test Case 6 : Discover Resources && Initiate 
& PUT Request on an available resource using link list interface. 
17:28.26657000 INFO: occlient: Test Case 7 : Discover Resources && Initiate 
Request on an unavailable resource using default interface. 
17:28.26662000 INFO: occlient: Test Case 8 : Discover Resources && Initiate 
Request on an unavailable resource using batch interface. 
17:28.26666000 INFO: occlient: Test Case 9 : Discover Resources && Initiate 
Request on an unavailable resource using link list interface. 
liyonghuadeMacBook-Pro:SimpleClientServer liyonghua$ ./occlientcoll -t 1 -c 








启动 occlientcoll 











第 12 章 “OCF 开 发 方法 及 案例 |P 281 





liyonghuadeMacBook-Pro:SimpleClientServer liyonghua$ ./occlientcoll -t 1 -c 0 B 
8:39.69057000 occlient: Entering occlient main loop 
41.74565000 occlient: Entering discoveryReqCB (Application Layer CB) 
41.74598000 occlient: StackResult: OC STACK OK 
18:41.74603000 occlient: Callback Context recvd successfully 
18:41.74608000 : occlient: Device => Discovered @ fe80::3e15:c2f 
f: feda:41d8:50701 
18:41. 74617000 Payloadlog: Payload Type: Discovery 
18:41.74622000 : PayloadLog: SID: 101dd639-1976-4ba1-a9d4-98e5afc7a7a 
9 
18:41.74625000 PayloadLog: Interface: 
41.74630000 oic.if. ll 
41.74635000 Resource #1 
41.74641000 URI:/oic/sec/doxm 
141.74644000 PayloadLog: Resource Types: 
:41.74647000 : PayloadLog: oic.r.doxm 
141.74649000 PayloadLog: Interfaces 
41.74652000 oic.if.baseline 
41.74655000 Bitmap: 1 
41.74658000 Secure?: false 
41.74661000 Port: 0 
:41.74663000 PayloadLog 
18:41.74666000 INFO: PayloadLog: Resource #2 
18:41.74669000 INFO: PayloadLog: URI:/oic/sec/pstat 





图 12-3 客户 端 发 现 # 





Get Query: /a/room?if=oic.if.baseline 

18:43.80262000 INF0: occlient: StackResult: OC STACK OK 
3143,80306000 occlient: SEQUENCE NUMBER: 16777216 
:43.80316000 INFO: occlient: Callback Context for Get recvd successfully 1 
:43.80322000 PayloadLog: Payload Type: Representation 
43.80333000 Resource #1 
43.80341000 URI: /a/room 
43.80367000 Resource Types: 
43.80371000 core. room 
43.80375000 : PayloadLog: Interfaces: 
43.80379000 INFO: PayloadLog: oic.if.baseline 
43.80384000 PayloadLog: oic.if.b 
143. 80388000 PayloadLog: oic.if.ll 
:43.80391000 INFO: PayloadLog: Values: 
:43. 80395000 PayloadLog: Resource #2 
43.80399000 URI:/a/light 
43.80401000 Resource Types: 
43.80404000 core. Light 
43.80407000 Interfaces 
:43. 80409000 PayloadLog: oic.if.baseline 
143.80412000 : PayloadLog: Values: 
143.80415000 PayloadLog: Resource #3 
:43. 80418000 PayloadLog: URI: /a/fan 
:43.80420000 INFO: PayloadLog: Resource Types: 





图 12-4 客户 端 通过 GET 操作 获取 资源 信息 
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1. ocservercoll. cpp 


# include < stdio. h> 
# include < string. h> 
# include < string> 
# include < stdlib. h> 
# include < unistd. h> 
# include < signal. h> 
# include < pthread. h> 
# include < ocstack. h> 
# include < logger. h> 
# include "ocpayload. h" 
const char * getResult(OCStackResult result); 
# def ine TAG PCF("ocservercontainer" ) 
volatile sig atomic t gQuitFlag = 0; 
int gLightUnderObservation = 0; 
void createResources(); 
typedef struct LIGHTRESOURCE( 
OCResourceHandle handle; 
bool state; 
int power; 
) LightResource; 
static LightResource light; 
char * gLightResourceUri= (char * )"/a/light"; 
char * gRoomResourceUri= (char * )"/a/room"; 
char * gFanResourceUri= (char * )"/a/fan"; 
typedef enum 
{ 
TEST_INVALID = 0, 
TEST DEFAULT COLL EH, 
TEST APP COLL EH, 
MAX TESTS 
) SERVER TEST; 
void PrintUsage() 
{ 
OIC LOG(INFO, TAG, "Usage : ocservercoll - t <Test Case>"); 
OIC LOG(INFO, TAG, 
"Test Case 1 : Create room resource with default collection entity handler."); 
OIC LOG(INFO, TAG, 
"Test Case 2 : Create roon resource with application collection entity handler."); 
) 
unsigned static int TEST - TEST INVALID; 
static void 
PrintReceivedMsgInfo(O0CEntityHandlerFlag flag, OCEntityHandlerRequest * ehRequest) 
{ 
const char * typeOfMessage; 
const char * typeOfMethod; 
switch (flag) 
{ 
case OC_REQUEST_FLAG: 
typeOfMessage = "OC REQUEST FLAG"; 
break; 
case OC OBSERVE FLAG: 
typeOfMessage - "OC OBSERVE FLAG"; 
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break; 
default: 
typeOfMessage = "UNKNOWN"; 
} 
if (ehRequest == NULL) 
{ 
typeOfMethod = "UNKNOWN"; 
} 
else if (ehRequest - > method == OC REST GET) 
{ 
typeOfMethod = "OC REST GET"; 
) 
else 
{ 
typeOfMethod = "OC REST PUT"; 
) 
OIC LOG V(INFO, TAG, "Receiving message type: * s, method % s", typeOfMessage, 
typeOfMethod) ; 
} 
// 实 体 处 理 句柄 ,只 用 于 不 存在 的 资源 
OCEntityHandlerResult 
OCDeviceEntityHandlerCb (OCEntityHandlerFlag flag, 
OCEntityHandlerRequest * entityHandlerRequest, char * uri, void* / * callbackParam * /) 
{ 
OIC LOG V(INFO, TAG, "Inside device default entity handler — flags: 0x%x, uri: *s", flag, uri); 
OCEntityHandlerResult ehResult - OC EH OK; 
OCEntityHandlerResponse response; 
if (! entityHandlerRequest) 
{ 
OIC LOG(ERROR, TAG, "Invalid request pointer"); 
return OC EH ERROR; 


if (entityHandlerRequest -> resource == NULL) 
{ 
OIC LOG(INFO, TAG, "Received request from client to a non - existing resource"); 
ehResult = OC EH RESOURCE NOT FOUND; 


else 

{ 

OIC LOG V(INFO, TAG, "Device Handler: Received unsupported request from client &d", 
entityHandlerRequest 一 > method) ; 

ehResult = OC EH ERROR; 





if (!((ehResult == OC EH ERROR) || (ehResult == OC EH FORBIDDEN))) 
{ 
// 生 成 响应 消息 . 注意 ,这 个 需要 一 些 与 请 求 消息 有 关 的 信息 
response. requestHandle = entityHandlerRequest - > requestHandle; 
response.resourceHandle = entityHandlerRequest — > resource; 
response. ehResult = ehResult; 
response. payload = nullptr; 
response. nunSendVendorSpecificHeaderOptions = 0; 
memset (response. sendVendorSpecif icHeaderOpt ions, 
0, sizeof response. sendVendorSpecif icHeaderOptions) 
// 表 明 该 响应 消息 不 在 持久 的 缓存 中 
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} 


response. persistentBufferFlag = 0; 

// 发 送 响 应 消息 

if (OCDoResponse(&response) != OC STACK OK) 

{ 
OIC LOG(ERROR, TAG, "Error sending response"); 
ehResult = OC EH ERROR; 


return ehResult; 


} 


//Roon 资源 的 实体 处 理 句柄 
OCEntityHandlerResult OCEntityHandlerRoomCb(OCEntityHandlerFlag flag, 


OCEntityHandlerRequest * ehRequest, 
void* /*callback* /) 


OCEntityHandlerResult ret = OC FH OK; 
OCEntityHandlerResponse response; 

OIC LOG V(INFO, TAG, "Callback for Room") ; 
PrintReceivedMsgInfo(flag, ehRequest ); 
if(ehRequest && flag == OC REQUEST FLAG ) 


{ 


std::string query = (const char * )ehRequest — > query; 
OCRepPayload * payload = OCRepPayloadCreate(); 
// 请 求 操作 类 型 是 GET 
if(OC REST GET == ehRequest 一 > method) 
f 
if(query.find(OC RSRVD INTERFACE DEFAULT) != std::string::npos) 
{ 
OCRepPayloadSetUri(payload, gRoomResourceUri) ; 
OCRepPayloadSetPropString( payload, "name", "John's Room"); 
OCRepPayload * tempPayload = OCRepPayloadCreate(); 
OCRepPayloadSetUri(tempPayload, gLightResourceUri); 
OCRepPayloadAppend(payload, tempPayload); 
OCRepPayload * tempPayload2 = OCRepPayloadCreate(); 
OCRepPayloadSetUri(tempPayload2, gFanResourceUri); 
OCRepPayloadAppend( payload, tempPayload2); 
} 
else if(query.find(OC RSRVD INTERFACE LL) != std::string::npos) 
i 
OCRepPayloadSetUri(payload, gRoomResourceUri); 
OCRepPayload * tempPayload = OCRepPayloadCreate(); 
OCRepPayloadSetUri(tempPayload, gLightResourceUri); 
OCRepPayloadAppend(payload, tempPayload); 
OCRepPayload * tempPayload2 = OCRepPayloadCreate(); 
OCRepPayloadSetUri(tempPayload2, gFanResourceUri); 
OCRepPayloadAppend(payload, tempPayload2); 
) 
else if(query.find(OC RSRVD INTERFACE BATCH) != std::string::npos) 
Í 
OCRepPayloadSetUri(payload, gRoomResourceUri); 
OCRepPayload * tempPayload = OCRepPayloadCreate(); 
OCRepPayloadSetUri(tempPayload, gLightResourceUri); 
OCRepPayloadSetPropBool(tempPayload, "state", false); 
OCRepPayloadSetPropInt(tempPayload, "power", 0); 
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OCRepPayloadAppend(payload, tempPayload); 
OCRepPayload * tempPayload2 = OCRepPayloadCreate(); 
OCRepPayloadSetUri(tempPayload2, gFanResourceUri); 
OCRepPayloadSetPropBool(tempPayload2, "state", true); 
OCRepPayloadSetPropInt(tempPayload2, "speed", 10); 
OCRepPayloadAppend(payload, tempPayload2); 

} 

if (ret == OC_EH_OK) 

{ 
// 生 成 响应 消息 .注意 ,这 个 需要 一 些 与 请 求 消息 有 关 的 信息 
response.requestHandle = ehRequest - > requestHandle; 
response.resourceHandle = ehRequest - > resource; 
response.ehResult = ret; 
response.payload = reinterpret cast < OCPayload * »(payload); 
response. numSendVendorSpecificHeaderOptions - 0; 
memset (response. sendVendorSpec if icHeaderOpt ions, 

0, sizeof response. sendVendorSpecif icHeaderOptions) ; 

memset (response. resourceUri, 0, sizeof response. resourceUri) ; 


// 表 明 该 响应 消息 不 在 持久 的 缓存 中 
response. persistentBufferFlag = 0; 
// 发 送 响 应 消息 


if (OCDoResponse(&response) != OC STACK OK) 

t 
OIC LOG(ERROR, TAG, "Error sending response"); 
ret - OC EH ERROR; 


i 


) 
// 请 求 操作 类 型 是 PUT 
else if(OC_REST PUT == ehRequest - > method) 
{ 
if(query.find(OC RSRVD INTERFACE DEFAULT) != std::string: :npos) 
{ 
if(ret != OC EH ERROR) 
{ 
OCRepPayloadSetUri( payload, gRoomResourceUri) ; 
OCRepPayloadSetPropString( payload, "name", "John's Room"); 


M find(OC RSRVD INTERFACE LL) != std::string::npos) 
i if(ret != OC EH ERROR) 

j OCRepPayloadSetUri(payload, gRoomResourceUri); 

JT !- OC EH ERROR) 

à OCRepPayload * tempPayload = OCRepPayloadCreate(); 
OCRepPayloadSetUri(tempPayload, gLightResourceUri); 
OCRepPayloadAppend(payload, tempPayload); 

ree !- OC EH ERROR) 

l OCRepPayload * tempPayload = OCRepPayloadCreate(); 
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OCRepPayloadSetUri(tempPayload, gFanResourceUri); 
OCRepPayloadAppend(payload, tempPayload); 
} 
} 
if(query.find(OC RSRVD INTERFACE BATCH ) != std::string: :npos) 
t 
if(ret != OC EH ERROR) 
{ 
OCRepPayloadSetUri(payload, gRoomResourceUri); 
} 
if(ret != OC EH ERROR) 
{ 
OCRepPayload * tempPayload = OCRepPayloadCreate( ) ; 
OCRepPayloadSetUri(tempPayload, gLightResourceUri); 
OCRepPayloadSetPropBool(tempPayload, "state", true); 
OCRepPayloadSetPropInt(tempPayload, "power", 0); 
OCRepPayloadAppend(payload, tempPayload); 
) 
if(ret != OC EH ERROR) 
{ 
OCRepPayload * tempPayload = OCRepPayloadCreate( ) ; 
OCRepPayloadSetUri(tempPayload, gFanResourceUri) ; 
OCRepPayloadSetPropBool ( tempPayload, "state", false); 
OCRepPayloadSetPropInt(tempPayload, "speed", 0); 
OCRepPayloadAppend(payload, tempPayload); 
) 
I 
if (ret == OC EH OK) 
{ 
// 生 成 响应 消息 . 注意 ,这 个 需要 一 些 与 请 求 消息 有 关 的 信息 
response.requestHandle - ehRequest 一 > requestHandle; 
response.resourceHandle - ehRequest 一 > resource; 
response.ehResult = ret; 
response. payload = reinterpret cast < OCPayload * >( payload) ; 
response. numSendVendorSpecificHeaderOptions = 0; 
memset ( response. sendVendorSpecif icHeaderOptions, 
0, sizeof response. sendVendorSpecif icHeaderOptions); 
memset(response.resourceUri, 0, sizeof response. resourceUri); 


// 表 明 该 响应 消息 不 在 持久 的 缓存 中 
response. persistentBufferFlag = 0; 
// 发 送 响应 消息 


if (OCDoResponse(&response) != OC STACK OK) 

{ 
OIC LOG(ERROR, TAG, "Error sending response"); 
ret = OC EH ERROR; 


) 
else 
t 
OIC LOG V (INFO, TAG, "Received unsupported method % d from client", 
ehRequest — > method) ; 
OCRepPayloadDestroy(payload); 
ret - OC EH ERROR; 
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) 
) 
else if (ehRequest && flag == OC OBSERVE FLAG) 
{ 
gLightUnderObservation = 1; 
) 
return ret; 
} 
//vight 资源 的 实体 处 理 句柄 
OCEntityHandlerResult OCEntityHandlerLightCb(OCEntityHandlerFlag flag, 
OCEntityHandlerRequest * ehRequest,void* / * callbackParam * /) 
{ 
OCEntityHandlerResult ret = OC_EH_OK; 
OCEnt ityHandlerResponse response; 
OIC_LOG_V(INFO, TAG, "Callback for Light"); 
PrintReceivedMsgInfo(flag, ehRequest ); 
if(ehRequest && flag == OC REQUEST FLAG) 
{ 
OCRepPayload * payload = OCRepPayloadCreate(); 
if(OC REST GET == ehRequest - > method) 
f 
OCRepPayloadSetUri(payload, gLightResourceUri); 
OCRepPayloadSetPropBool(payload, "state", false); 
OCRepPayloadSetPropInt(payload, "power", 0); 
) 
else if(OC REST PUT == ehRequest - > method) 
{ 
OCRepPayloadSetUri( payload, gLightResourceUri) ; 
OCRepPayloadSetPropBool (payload, "state", true); 
OCRepPayloadSetPropInt( payload, "power", 0); 
) 
else 
{ 
OIC LOG V (INFO, TAG, "Received unsupported method %d from client", 
ehRequest 一 > method) ; 
ret - OC EH ERROR; 
} 


if (ret = 





OC EH OK) 


// 生 成 响应 消息 .注意 ,这 个 需要 一 些 与 请 求 消息 有 关 的 信息 
response.requestHandle = ehRequest - > requestHandle; 
response.resourceHandle = ehRequest — > resource; 
response. ehResult = ret; 
response. payload = reinterpret_cast < OCPayload * >( payload) ; 
response. numSendVendorSpecificHeaderOptions = 0; 
memset (response. sendVendorSpecif icHeaderOptions, 

0, sizeof response. sendVendorSpecif icHeaderOpt ions) ; 
memset (response. resourceUri, 0, sizeof response. resourceUri) ; 


// 表 明 该 响应 消息 不 在 持久 的 缓存 中 
response. persistentBufferFlag = 0; 
// 发 送 响应 消息 


if (OCDoResponse(&response) != OC STACK OK) 
{ 
OIC_LOG(ERROR, TAG, "Error sending response"); 
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ret = OC EH ERROR; 


) 
else 
t 
OCRepPayloadDestroy(payload); 
) 
} 
else if (ehRequest && flag == OC OBSERVE FLAG) 
{ 
gLightUnderObservation = 1; 
) 
return ret; 
} 
// Fan 资源 的 实体 处 理 句柄 
OCEntityHandlerResult OCEntityHandlerFanCb(OCEntityHandlerFlag flag, 
OCEntityHandlerRequest * ehRequest, void* / * callback * /) 
{ 
OCEntityHandlerResult ret = OC FH OK; 
OCEntityHandlerResponse response; 
OIC LOG V(INFO, TAG, "Callback for Fan"); 
PrintReceivedMsgInfo(flag, ehRequest ); 
if(ehRequest && flag == OC REQUEST FLAG) 
{ 
OCRepPayload * payload = OCRepPayloadCreate(); 
if(OC REST GET == ehRequest -> method) 
{ 
OCRepPayloadSetUri(payload, gFanResourceUri); 
OCRepPayloadSetPropBool(payload, "state", true); 
OCRepPayloadSetPropInt(payload, "speed", 10); 
) 
else if(OC REST PUT == ehRequest - > method) 
{ 
OCRepPayloadSetUri(payload, gFanResourceUri); 
OCRepPayloadSetPropBool(payload, "state", false); 
OCRepPayloadSetPropInt(payload, "speed", 0); 
) 
else 
{ 
OIC LOG V (INFO, TAG, "Received unsupported method % d from client", 
ehRequest - > method) ; 
ret - OC EH ERROR; 
} 
if (ret == OC_EH_OK) 
{ 
// 生 成 响应 消息 . 注意 ,这 个 需要 一 些 与 请 求 消息 有 关 的 信息 
response.requestHandle = ehRequest - » requestHandle; 
response.resourceHandle = ehRequest — resource; 
response. ehResult = ret; 
response. payload = reinterpret_cast < OCPayload * >( payload) ; 
response. numSendVendorSpecificHeaderOptions = 0; 
memset ( response. sendVendorSpecif icHeaderOptions, 
0, sizeof response. sendVendorSpecif icHeaderOpt ions) ; 
memset (response. resourceUri, 0, sizeof response. resourceUri) ; 
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// 表 明 该 响应 消息 不 在 持久 的 缓存 中 
response.persistentBufferFlag = 0; 
// 发 送 响应 消息 
if (OCDoResponse(&response) != OC STACK OK) 
t 
OIC LOG(ERROR, TAG, "Error sending response"); 
ret - OC EH ERROR; 
i 
} 
OCRepPayloadDestroy( payload) ; 
) 
else if (ehRequest && flag == OC OBSERVE FLAG) 
{ 
gLightUnderObservation = 1; 
) 
return ret; 
} 
/ * SIGINT 处 理 程序 : 将 gQuitFlag 设置 为 1, 以便 正常 终止 */ 
void handleSigInt(int signum) 
{ 
if (signum == SIGINT) 
{ 
gQuitFlag = 1; 
) 
} 
void * ChangeLightRepresentation (void * param) 
{ 
(void) param; 
OCStackResult result = OC STACK ERROR; 
while (!gQuitFlag) 
{ 
sleep(10); 
light.power += 5; 
if (gLightUnderObservation) 
í 
OIC LOG V(INFO, TAG, 

" == > Notifying stack of new power level * d\n", light. power); 
result = OCNotifyAllObservers (light. handle, OC NA Q0S); 
if (OC STACK NO OBSERVERS == result) 

f 





gLightUnderObservation - 0; 
} 


} 
return NULL; 
} 
int main(int argc, char * argv[]) 


{ 
pthread t threadId; 
int opt; 
while ((opt = getopt(argc, argv, "t:")) != 一 1) 


{ 
switch(opt) 
{ 
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case 't': 
TEST - atoi(optarg); 
break; 
default: 
PrintUsage(); 
return -1; 


) 
} 
if(TEST <= TEST_INVALID || TEST>= MAX_TESTS) 
{ 

PrintUsage( ) ; 

return -1; 
} 
OIC LOG(DEBUG, TAG, "OCServer is starting..."); 
if (OCInit(NULL, 0, OC SERVER) != OC STACK OK) 
{ 

OIC LOG(ERROR, TAG, "OCStack init error"); 

return 0; 
) 
OCSetDefaultDeviceEntityHandler(OCDeviceEntityHandlerCb, NULL); 
/ * 声明 并 创建 示例 资源 : light / 
createResources(); 
/ * 创建 一 个 用 于 更 改 light 资源 表示 的 线程 * / 
pthread create (&threadId, NULL, ChangeLightRepresentation, (void * )NULL); 
// 使 用 ctrl C 退出 循环 
OIC LOG(INFO, TAG, "Entering ocserver main loop..."); 
signal(SIGINT, handleSigInt); 
while (!gQuitFlag) 
{ 

if (OCProcess() != OC STACK OK) 

{ 

OIC LOG(ERROR, TAG, "OCStack process error"); 
return 0; 
) 
sleep(2); 


) 
/ * 取消 Light 资源 的 线程 并 等 待 它 终止 * / 
pthread cancel(threadId); 
pthread join(threadId, NULL); 
OIC LOG(INFO, TAG, "Exiting ocserver main loop..."); 
if (OCStop() != OC STACK OK) 
{ 
OIC LOG(ERROR, TAG, "OCStack process error"); 
) 
return 0; 
) 
void createResources() 
{ 
light.state = false; 
OCResourceHandle fan; 
OCStackResult res = OCCreateResource(&fan, 
"core. fan", 
OC RSRVD INTERFACE DEFAULT, 
"/a/fan", 
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OCEntityHandlerFanCb, 
NULL, 
OC DISCOVERABLE|OC OBSERVABLE); 
OIC LOG V(INFO, TAG, "Created fan resource with result: % s", getResult(res)); 
OCResourceHandle light; 
res = OCCreateResource(&light, 
"core. light", 
OC RSRVD INTERFACE DEFAULT, 
"/a/light", 
OCEntityHandlerLightCb, 
NULL, 
OC DISCOVERABLE|OC OBSERVABLE); 
OIC LOG V(INFO, TAG, "Created light resource with result: %s", getResult(res)); 
OCResourceHandle room; 
if(TEST -- TEST APP COLL EH) 
{ 
res = OCCreateResource(&room, 
"core. room", 
OC RSRVD INTERFACE BATCH, 
"/a/roon" , 
OCEntityHandlerRoonCb, 
NULL, 
OC DISCOVERABLE) ; 


res 7 OCCreateResource(&room, 
"core. room", 
OC RSRVD INTERFACE BATCH, 
"/a/roon" , 


OC DISCOVERABLE) ; 

) 

OIC LOG V(INFO, TAG, "Created room resource with result: %s", getResult(res)); 

OCBindResourceInterfaceToResource(room, OC RSRVD INTERFACE LL); 

OCBindResourceInterfaceToResource(room, OC RSRVD INTERFACE DEFAULT); 

res = OCBindResource(room, light); 

OIC LOG V(INFO, TAG, "OC Bind Contained Resource to resource: 5s", getResult(res)); 

res = OCBindResource(room, fan); 

OIC LOG V(INFO, TAG, "OC Bind Contained Resource to resource: 5s", getResult(res)); 
) 


2. occlientcoll. cpp 


# include < stdio. h> 

# include < stdlib. h> 

# include < string. h> 

# include < signal. h> 
# include < unistd. h> 
# include < ocstack. h> 
# include < iostream> 
# include < sstream> 

# include "ocpayload. h" 
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# include "payload_logging. h" 

# include "logger. h" 

const char * getResult(OCStackResult result); 
std: :string getQueryStrForGetPut(); 
# define TAG ("occlient") 

# define DEFAULT CONTEXT VALUE 0x99 
i ifndef MAX LENGTH IPv4 ADDR 

f define MAX LENGTH IPv4 ADDR 16 

# endif 

typedef enum 

{ 





TEST_INVALID = 0, 
TEST GET DEFAULT, 
TEST GET BATCH, 
TEST GET LINK LIST, 
TEST PUT DEFAULT, 
TEST PUT BATCH, 
TEST PUT LINK LIST, 
TEST UNKNOWN RESOURCE GET DEFAULT, 
TEST UNKNOWN RESOURCE GET BATCH, 
TEST UNKNOWN RESOURCE GET LINK LIST, 
MAX TESTS 
) CLIENT TEST; 
/ * 可 以 在 客户 端 初始 化 的 连接 类 型 列表 ,用 户 输入 验证 时 需要 * / 
typedef enum { 
CT ADAPTER DEFAULT = 0, 
CT IP, 
MAX CT 
) CLIENT ConnectivityType TYPE; 
unsigned static int TestType - TEST INVALID; 
unsigned static int ConnectivityType = 0; 
typedef struct 
{ 
char text[30]; 
CLIENT_TEST test; 
) testToTextMap; 
testToTextMap queryInterface[] = ( 
{"invalid", TEST INVALID), 
{"?if = oic. if. baseline", TEST GET DEFAULT), 
{"?if = oic. if.b", TEST GET BATCH), 
("?if = oic. if. 11", TEST GET LINK LIST), 
{"?if = oic. if. baseline", TEST UNKNOWN RESOURCE GET DEFAULT), 
{"?if = oic.if.b", TEST UNKNOWN RESOURCE GET BATCH], 
{"?if = oic. if.11", TEST UNKNOWN RESOURCE GET LINK LIST), 
{"?if = oic. if. baseline", TEST PUT DEFAULT), 
{"?if = oic. if.b", TEST PUT BATCH), 
{"?if = oic. if. 11", TEST PUT LINK LIST), 





i 

// 以 下 变量 决定 了 用 于 发 送 单 播 消息 的 接口 协议 (IP 协议 等 ). 默 认 设 为 IP 协 议 
static OCConnectivityType ConnType = CT ADAPTER IP; 

static const char * RESOURCE DISCOVERY QUERY - "/oic/res"; 

//observe 注册 句柄 

OCDoHandle gObserveDoHandle; 

// 超 过 阔 值 后 ,客户 端 将 注销 以 进一步 观察 
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int gNumObserveNotifies = 1; 
int gQuitFlag = 0; 
/ * SIGINT 处 理 器 :设置 gQuitFlag 为 1 以 便 正常 终止 */ 
void handleSigInt(int signum) 
{ 
if (signum == SIGINT) 
{ 
gQuitFlag = 1; 
} 
} 
// 函 数 声明 
OCStackApplicationResult getReqCB(void * ctx, OCDoHandle handle, OCClientResponse * clientResponse); 
int InitGetRequestToUnavailableResource(OCClientResponse * clientResponse); 
int InitObserveRequest(OCClientResponse * clientResponse); 
int InitPutRequest(OCClientResponse * clientResponse); 
int InitGetRequest(OCClientResponse * clientResponse) ; 
int InitDiscovery(); 
OCPayload * putPayload() 
{ 
OCRepPayload * payload = OCRepPayloadCreate(); 
if(!payload) 
{ 
std: :cout << "Failed to create put payload object"<< std::endl; 
std: :exit(1); 
) 
OCRepPayloadSetPropInt(payload, "power", 15); 
OCRepPayloadSetPropBool(payload, "state", true); 
return (OCPayload * ) payload; 
} 
void PrintUsage( ) 
{ 
OIC LOG(INFO, TAG, "Usage : occlientcoll -~ t « Test Case» — c « CA connectivity Type>"); 
OIC LOG(INFO, TAG, " -c 0 : Default auto- selection"); 
OIC LOG(INFO, TAG, "c 1 : IP Connectivity Type"); 
OIC LOG(INFO, TAG, "Test Case 1 : Discover Resources && Initiate GET Request on an "V 
"available resource using default interface."); 
OIC LOG(INFO, TAG, "Test Case 2 : Discover Resources && Initiate GET Request on an "V 
"available resource using batch interface. "); 
OIC LOG(INFO, TAG, "Test Case 3 : Discover Resources && Initiate GET Request on an "V 
"available resource using link list interface."); 
OIC LOG(INFO, TAG, "Test Case 4 : Discover Resources && Initiate GET & PUT Request on an "V 
"available resource using default interface."); 
OIC LOG(INFO, TAG, "Test Case 5 : Discover Resources && Initiate GET & PUT Request on an "V 
"available resource using batch interface. "); 
OIC LOG(INFO, TAG, "Test Case 6 : Discover Resources && Initiate GET & PUT Request on an "V 
"available resource using link list interface. "); 
OIC LOG(INFO, TAG, "Test Case 7 : Discover Resources && Initiate GET Request on an "V 
"unavailable resource using default interface. "); 
OIC LOG(INFO, TAG, "Test Case 8 : Discover Resources && Initiate GET Request on an "V 
"unavailable resource using batch interface."); 
OIC LOG(INFO, TAG, "Test Case 9 : Discover Resources && Initiate GET Request on an "V 
"unavailable resource using link list interface. "); 
) 
OCStackApplicationResult putReqCB(void * ctx, OCDoHandle / * handle * /, 
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OCClientResponse * clientResponse) 


if(clientResponse == NULL) 
t 
OIC LOG(INFO, TAG, "The clientResponse is NULL"); 
return OC STACK DELETE TRANSACTION; 
) 
if(ctx == (void* )DEFAULT CONTEXT VALUE) 
{ 
OIC LOG V(INFO, TAG, "Callback Context for PUT query recvd successfully"); 
OIC LOG PAYLOAD(INFO, clientResponse - > payload); 
) 
return OC STACK KEEP TRANSACTION; 
) 
OCStackApplicationResult getReqCB(void * ctx, OCDoHandle / * handle * /, 
OCClientResponse * clientResponse) 


{ 
OIC LOG V(INFO, TAG, "StackResult: %s", 
getResult(clientResponse - > result)); 
if(ctx == (void * )DEFAULT CONTEXT VALUE) 
t 
OIC LOG V(INFO, TAG, "SEQUENCE NUMBER: &d", clientResponse - > sequenceNumber) ; 
if(clientResponse — > sequenceNumber == 0) 
{ 
OIC LOG V(INFO, TAG, "Callback Context for GET query recvd successfully"); 
OIC LOG PAYLOAD(INFO, clientResponse - > payload); 
) 
else 
{ 
OIC LOG V(INFO, TAG, "Callback Context for Get recvd successfully *d", 
gNumObserveNot if ies); 
OIC LOG PAYLOAD(INFO, clientResponse - > payload);; 
gNumObserveNotifies++ ; 
if (gNumObserveNotifies == 3) 
£ 
if (OCCancel (gObserveDoHandle, OC LOW QOS, NULL, 0) != OC STACK OK) 
t 
OIC LOG(ERROR, TAG, "Observe cancel error"); 
) 
) 
} 
} 
if(TestType == TEST_PUT_DEFAULT || TestType == TEST_PUT_BATCH || TestType == TEST_PUT_LINK_LIST) 
{ 
InitPutRequest (clientResponse) ; 
} 
return OC_STACK_KEEP_TRANSACTION; 
} 
// 当 设备 被 发 现时 此 函数 被 调用 
OCStackApplicationResult discoveryReqCB(void* ctx, OCDoHandle / * handle * /,OCClientResponse * clientResponse) 
t 


OIC LOG(INFO, TAG, 
"Entering discoveryReqCB (Application Layer CB)"); 
OIC LOG V(INFO, TAG, "StackResult: &s", 


} 


getResult(clientResponse — > result) ); 
if (ctx (void * ) DEFAULT CONTEXT VALUE) 


{ 





OIC LOG V(INFO, TAG, "Callback Context recvd successfully"); 


) 

OIC LOG V(INFO, TAG, 
"Device 
clientResponse - » devAddr. addr, 
clientResponse - > devAddr. port) ; 

OIC LOG PAYLOAD(INFO, clientResponse - > payload); 

ConnType = clientResponse - > connType; 





if(TestType -- TEST UNKNOWN RESOURCE GET DEFAULT || TestType 
TestType 





TEST UNKNOWN RESOURCE GET LINK LIST) 
{ 


InitGetRequestToUnavailableResource(clientResponse) ; 


) 


else 


{ 
InitGetRequest(clientResponse); 


) 
return OC STACK KEEP TRANSACTION; 


=> Discovered (à %s:%d", 
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== TEST UNKNOWN RESOURCE GET BATCH | | 


int InitGetRequestToUnavailableResource(OCClientResponse * clientResponse) 


{ 


OCStackResult ret; 

OCCallbackData cbData; 

std: :ostringstream getQuery; 

getQuery << "/SomeUnknownResource" ; 

cbData.cb = getReqCB; 

cbData. context = (void * )DEFAULT CONTEXT VALUE; 
cbData.cd = NULL; 


ret = OCDoResource(NULL, OC_REST_GET, getQuery. str().c_str(), 


&clientResponse -> devAddr, 0, ConnType, OC_LOW_QOS, 
&cbData, NULL, 0); 


) 


int InitObserveRequest(OCClientResponse * clientResponse) 


{ 


if (ret != OC STACK OK) 
{ 
OIC LOG(ERROR, TAG, "OCStack error"); 
}resource 
return ret; 


OCStackResult ret; 

OCCallbackData cbData; 

OCDoHandle handle; 

std: :ostringstream obsReg; 

obsReg «« getQueryStrForGetPut() ; 

cbData.cb = getReqCB; 

cbData.context = (void * )DEFAULT CONTEXT VALUE; 
cbData.cd = NULL; 

OIC LOG V(INFO, TAG, "OBSERVE payload from client 
OCPayload * payload = putPayload(); 

OIC LOG PAYLOAD(INFO, payload); 
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OCPayloadDestroy(payload); 
ret = OCDoResource(&handle, OC REST OBSERVE, obsReg.str().c str(), 
&clientResponse - > devAddr, 0, ConnType, 
OC LOW QOS, &cbData, NULL, 0); 
if (ret != OC STACK OK) 
{ 
OIC LOG(ERROR, TAG, "OCStack resource error"); 
) 
else 
{ 
gObserveDoHandle = handle; 
) 
return ret; 
} 
int InitPutRequest(OCClientResponse * clientResponse) 
{ 
OCStackResult ret; 
OCCallbackData cbData; 
/ [3i fs PUT 查询 
std: :ostringstream getQuery; 
getQuery << "coap://" << clientResponse — > devAddr. addr << ":" << 
clientResponse — > devAddr. port << 
"/a/roon" << queryInterface[ TestType]. text; 
cbData.cb = putReqCB; 
cbData.context = (void * )DEFAULT CONTEXT VALUE; 
cbData.cd = NULL; 
OIC LOG V(INFO, TAG, "PUT payload from client = "); 
OCPayload * payload = putPayload(); 
OIC LOG PAYLOAD(INFO, payload); 
OCPayloadDestroy(payload); 
ret - OCDoResource(NULL, OC REST PUT, getQuery.str().c str(), 
&clientResponse - > devAddr, putPayload(), ConnType, 
OC LOW QOS, &cbData, NULL, 0); 
if (ret != OC STACK OK) 
{ 
OIC LOG(ERROR, TAG, "OCStack resource error"); 
) 
return ret; 
) 
int InitGetRequest(OCClientResponse * clientResponse) 
t 
OCStackResult ret; 
OCCallbackData cbData; 
// 进 行 GET 查询 
std: :ostringstream getQuery; 
getQuery «« "/a/room" << queryInterface[TestType]. text; 
std: :cout «« "Get Query: " «« getQuery. str() «« std: :endl; 
cbData.cb = getReqCB; 
cbData.context = (void * )DEFAULT CONTEXT VALUE; 
cbData.cd = NULL; 
ret - OCDoResource(NULL, OC REST GET, getQuery.str().c str(), 
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&clientResponse 一 > devAddr, 0, ConnType, OC_LOW_QOS, 
&cbData, NULL, 0); 
if (ret != OC STACK OK) 
{ 
OIC_LOG(ERROR, TAG, "OCStack resource error") ; 
} 
return ret; 
} 
int InitDiscovery() 
{ 
OCStackResult ret; 
OCCallbackData cbData; 
/* 开始 发 现 查询 * / 
char szQueryUri[MAX QUERY LENGTH] = { 0 }; 
Strcpy(szQueryUri, RESOURCE DISCOVERY QUERY); 
cbData.cb = discoveryReqCB; 
cbData.context = (void * )DEFAULT CONTEXT VALUE; 
cbData.cd = NULL; 
ret = OCDoResource(NULL, OC REST DISCOVER, szQueryUri, NULL, 0, ConnType, 
OC LOW QOS, 
&cbData, NULL, 0); 
if (ret != OC STACK OK) 
{ 
OIC LOG(ERROR, TAG, "OCStack resource error"); 
) 
return ret; 
} 
int main(int argc, char * argv[]) 
{ 
int opt; 
while ((opt = getopt(argc, argv, "t:c:")) != -1) 
{ 
switch (opt) 
{ 
case 't': 
TestType = atoi(optarg); 
break; 
case 'c': 
ConnectivityType = atoi(optarg); 
break; 
default: 
PrintUsage(); 
return -1; 


) 
if ((TestType «- TEST INVALID || TestType > = MAX TESTS) || 
ConnectivityType >= MAX CT) 


PrintUsage(); 
return -1; 
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/* 初始 化 OCStack* / 
if (OCInit(NULL, 0, OC CLIENT) != OC STACK OK) 
t 
OIC LOG(ERROR, TAG, "OCStack init error"); 
return 0; 
) 
if(ConnectivityType == CT ADAPTER DEFAULT || ConnectivityType == CT IP) 
{ 
ConnType = CT ADAPTER IP; 
) 
else 
{ 
OIC LOG(INFO, TAG, "Default Connectivity type selected. .."); 
ConnType - CT ADAPTER IP; 
) 
InitDiscovery(); 
// 使 用 ctrl + C 退出 循环 
OIC LOG(INFO, TAG, "Entering occlient main loop..."); 
Signal(SIGINT, handleSigInt); 
while (!gQuitFlag) 
{ 
if (OCProcess() != OC_STACK_OK) 
t 
OIC LOG(ERROR, TAG, "OCStack process error"); 


return 0; 
) 
sleep(2); 
) OIC LOG(INFO, TAG, "Exiting occlient main loop..."); 
if (OCStop() != OC STACK OK) 


{ 


OIC LOG(ERROR, TAG, "OCStack stop error"); 


) 


return 0; 


} 
std::string getQueryStrForGetPut() 


{ 
return "/a/roon" ; 


) 


12.2 基于 Windows 的 开发 方法 


本 节 包 括 软件 工具 的 安装 、Windows 环境 下 的 编译 方法 和 APP 实例 。 


12.2.1 软件 工具 的 安装 


(1) 安装 Visual Studio 2015 或 Visual Studio 2013 ,支持 所 有 版 本 ,包括 免费 社区 版 。 注 意 ,确保 在 
安装 时 勾 选 “C++Common Tools” 选 项 。 该 选项 在 安装 界面 的 Programming languages 目录 下 的 Visual 
C++ 中 能 找到 。 
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(2) 从 Web 安装 依赖 项 并 添加 到 PATH. 

(D Python2.7 (选择 *Install just for me") 

@ SCons (如 果 SCons 不 能 找到 Python ,尝试 安装 32 位 版 本 的 Python) 

F 载 7-Zip。 对 于 “64-bit x64? 使 用 *. exe” 版 本 启动 setup. exe 并 确保 7-zip 安装 路 径 存 在 于 环 

境 变量 中 。 
@ 下 载 cmake-3. 6.0-rcl-win64-x64. msi。 确 保 它 的 安装 路 径 存在 于 环境 
以 下 是 为 了 编译 IoTivity 而 添加 环境 变 量 的 示范 指令 ,假设 所 有 依赖 项 已 经 安装 到 64 位 系统 中 默 

认 位 置 意 ,此 命令 必须 从 管理 员 命令 提示 














变量 中 。 





setx PATH % PATH % ;C:\Python27\;C:\Python27\Scripts;C:\Program Files (x86)\CMake\bin;C:\Program Files\7 
- Zip 


(3) 下 载 安装 lotivity 工程 1. 2. 1 及 以 上 版 本 
12.2.2 Windows 环境 下 的 编译 方法 


CD 打开 命令 提示 符 , 进 入 Iotivity 工程 根 目录 ,并 使 用 *run. bat" 方 便 脚 本 调用 SCons。 
(2) 或 者 直接 调用 SCons 





scons TARGET OS = windows TARGET ARCH = amd64 \RELEASE = 0 WITH RA = 0 TARGET TRANSPORT = IP SECURED = 1 WITH - 
TCP = 0 NBUILD SAMPLE = ON LOGGING = OFF TEST = 1 


12.2.3 APP 实例 


该 实例 描述 基本 的 服务 器 端 和 客户 端 , 展 示 基 本 的 资源 发 现 过 程 和 资源 操作 。 实 例 实现 同 Linux 
系统 , 详 见 Linux 实例 代码 

CD. 编译 程序 成 功 后 ,分 别 执行 生成 的 执行 文件 simpleserver. exe 和 simpleclient. exe。 可 以 直接 
在 lotivity 的 根 目 录 下 执行 指令 : 








C:\path\to\iotivity\> run server 
C:\path\to\ iotivity\> run client 


(2) server 启动 后 ,将 创建 资源 并 等 待 .如 图 12-5 所 示 








图 12-5 启动 simpleserver 
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,如 图 12-6 所 示 


(3) 启动 client 后 ,将 发 现 server 创建 的 资源 以 及 已 经 存在 自 





图 12-6 启动 simpleclient 并 发 现 资源 





,对 server fy VE i 





进行 GET 操作 ,如 图 12-7 和 图 12-8 所 示 





图 12-7 server Xf GE 





E c a J 
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图 12-8 client 进行 GET 操作 


12.3 基于 Linux 的 开发 方法 


本 节 包 括 软件 工具 的 安装 Linux 环境 下 的 编译 方法 .APP 实例 和 代码 
12.3.1 软件 工具 的 安装 

软件 工具 安 
(D Linux #?% 


性 问题 ) 。 


(2) 源码 下 载 。 官 方 网 站 下 载 地 址 为 https://www. iotivity. org/downloads 


装 步骤 如 下 
完 版 本 : Ubuntu 12. 04.64 位 (推荐 使 用 12. 04.1 以 上 的 版 本 ,其余 版 本 会 存在 兼容 






git/gerrit 下 载 地 址 为 : https://gerrit. iotivity. org 
(3) 搭建 工具 和 库 文件 
在 “iotivity” 根 目录 下 运行 以 下 指令 人 





$ sudo apt- get install git- core scons ssh build- essential g++doxygen valgrind 
$ sudo apt- get install libboost ~ dev libboost - program - options - dev libboost - thread - dev uuid — dev 
libssl- dev libtool libglib2.0 - dev 

sudo apt - get install libboost - all - dev 


iE: Csdk 需要 安装 tinycbor, 在 根 目录 下 运行 git clone https://github. com/Olorg/tinycbor. git 


extlibs/tinycbor/tinycbor -b v0. 2.1 即 可 


12.3.2 Linux 环境 下 的 编译 方法 


编译 方法 如 下 。 
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(1) 编译 release 可 执行 文件 。 

$ scons 

(2) 编译 debug 可 执行 文件 。 

$ scons RELEASE = false 

(3) 运行 samples. 

$ export LD_LIBRARY_PATH = < iotivity»/out/linux/x86 64/release 


C++ sample 目录 : < iotivity >/out/linux/x86_64/release/resource/examples, 





C sample A x: < iotivity >/out/linux/x86 64/release/resource/csdk/stack/samples/ 


linux/SimpleClientServer 


12.3.3 APP 实例 
实例 描述 基本 的 服务 器 端 和 客户 端 ,展示 基本 的 资源 发 现 过 程 和 资源 操作 ， 

CD 程序 编译 成 功 后 ,命令 行进 入 C++ sample 目录 ,运行 生成 的 simpleserver 和 simpleclient, 如 
图 12-9 所 











OAA hxx@hxx: ~/Downloads/OCF/iotivity-1.1.1/out/linux/x86_64/release/resource/examples 


hxx@hxx:~$ cd Downloads/OCF/iotivity-1.1.1/out/linux/x86_64/release/resource/exa 
mples/ 

hxxghxx: - /Downloads/OCF /iotivity-1.1.1/out/linux/x86 64/release/resource/example 
s$ ./simpleserver 


Usage : simpleserver «value» 
Default - Non-secure resource and notify all observers 
1 - Non-secure resource and notify list of observers 


2 - Secure resource and notify all observers 
- Secure resource and notify list of observers 


- Non-secure resource, GET slow response, notify all observers 
Created resource. 
Added Interface and Type 
Waiting 





图 12-9. 启动 simpleserver 
(2) 启动 simpleclient 后 ,将 发 现 simpleserver 创建 的 资源 以 及 已 经 存在 的 资源 ,如 图 12-10 
所 示 。 
(3) simpleclient 发 现 资 源 后 ,对 simpleserver 的 资源 进行 GET,PUT 和 POST 等 操作 ,如 图 12-11 
和 图 12-12 所 示 。 


12.3.4 实例 代码 


本 节 包 括 simpleserver. cpp 和 simpleclient. cpp 的 代码 。 
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OSO hx@hxx ~/Downloads/OCF/iotivity-1.1.1/out/linux/x86_64/release/resource/examples 
hxx@hxx:~$ cd Downloads/OCF/iotivity-1.1.1/out/linux/x86 64/release/resource/ex 


-/Downloads/OCF /iotivity-1.1.1/0ut/linux/x86_64/release/resource/exampl 
s$ ./simpleclient 


Usage : simpleclient <ObserveType> 
ObserveType : 1 - Observe 
ObserveType : 2 - ObserveAll 


etting ObserveType to Observe and ConnectivityType to IP. 


Finding Resource... 
Finding Resource for second time... 
In foundResource 
Found resource 31313131-3131-3131-3131-313131313131/a/light for the first time o 
n server with ID: 31313131-3131-3131-3131-313131313131 
DISCOVERED Resource: 
URI of the resource: /a/light 
Host address of the resource: coap://[fe80::20c:29ff:fed7:3a80]:56363 
List of resource types: 
core.light 
core.brightlight 





图 12-10 启动 simpleclient 并 发 现 资源 


OSO bxx@hxx ~/Downloads/OCF/iotivity-1.1.1/out/linux/x86_64/release/resource/examples 
In entity handler wrapper: 


In Server CPP entity handler: 
requestFlag : Request 
requestType 
e: 
In entity handler wrapper: 


In Server CPP entity handler: 
requestFlag : Request 
requestType : PUT 
state: 1 
power: 15 
e: 
In entity handler wrapper: 


In Server CPP entity handler: 
requestFlag : Request 
requestType 
e: 
In entity handler wrapper: 


In Server CPP entity handler: 
requestFlag : Request 





图 12-11 simpleserver 对 操作 的 响应 
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OSO hxQhoc: -/Downloads/OCF/lotivity-1.1.1/out/linux/x86, 64/release/resource/examples 


PUT request was successful 
state: true 
power: 15 
name: John's lig 
Posting light representation... 
POST request was successful 
Uri of the created resource: /a/light1 
Posting light representation... 
POST request was successful 
state: true 
power: 55 
name: John's light 


Observe is used. 


registration action is successful 
RESULT: 
SequenceNumber: 6 
state: true 
power: 55 
name: John's Light 
OBSERVE RESULT: 
SequenceNumber: 1 
state: true 





图 12-12 simpleclient 对 资源 执行 操作 
1. simpleserver. cpp 


# include < functional > 

# include < pthread. h> 

# include < mutex > 

f include < condition_variable> 

# include "OCPlatform. h" 

# include "OCApi. h" 

using namespace OC; 

using namespace std; 

namespace PH = std::placeholders; 

static const char * SVR DB FILE NAME = "./oic svr db server.dat"; 
int gObservation 7 0; 

void * ChangeLightRepresentation (void * param); 

void * handleSlowResponse (void * param, std::shared ptr < OCResourceRequest > pRequest) ; 
// 指 定 通知 所 有 的 observers 或 者 部 分 observers 

//false: 通 知 所 有 observers 

//true: 通 知 部 分 observers 

bool isListOfObservers = false; 

// 指 定安 全 或 非 安全 

//false: 非 安全 资源 

//true: 安 全 资源 

bool isSecure = false; 

// 指 定 实体 处 理 句 柄 是 否 做 慢 响 应 

bool isSlowResponse = false; 

// 这 个 类 表示 一 个 名 为 LightResource 的 资源 ,该 资源 有 两 个 名 为 state 和 power 的 简单 属性 


class LightResource 


{ 

public: 
// 从 TB 客户 端 访问 这 些 属性 
std::string m name; 





bool m state; 


int m power; 

std::string m lightUri; 
OCResourceHandle m resourceHandle; 
OCRepresentation m lightRep; 
ObservationIds m interestedObservers; 


public: 


// 构 造 函 数 


LightResource() 
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:m name("John's light"), m state(false), m power(0), m lightUri("/a/light"), 


m resourceHandle(nullptr) { 
m lightRep. setUri(m_lightUri) ; 
m lightRep. setValue("state", m state); 
n lightRep. setValue("power", m power); 
m lightRep. setValue("name", m name); 


) 


// 注 意 ,这 不 需要 是 一 个 成 员 函 数 ,对 于 没有 访问 的 类 ,可 以 使 用 一 个 自由 函数 来 实现 


// 这 个 函数 在 内 部 调用 API 函数 registerResource 


void createResource() 


// 资 源 的 URI 
std::string resourceURI = m lightUri; 
// 资 源 类 型 名 称 . 在 此 是 指 Light 
std::string resourceTypeName = "core. light"; 
// 资 源 接口 
std: :string resourceInterface = DEFAULT_INTERFACE; 
// 资 源 属 性 定义 在 ocstack. h 
uint8_t resourceProperty; 
if(isSecure) 


{ 


resourceProperty = OC DISCOVERABLE | OC OBSERVABLE | OC SECURE; 


) 
else 
{ 
resourceProperty = OC DISCOVERABLE | OC OBSERVABLE; 
) 


EntityHandler cb = std::bind(&LightResource::entityHandler, this,PH:: 1); 


// 此 PI 会 在 内 部 创建 和 注册 资源 
OCStackResult result = OCPlatform::registerResource( 


m resourceHandle, resourceURI, resourceTypeName, 
resourceInterface, cb, resourceProperty); 


if (OC STACK OK != result) 
t 
cout << "Resource creation was unsuccessful" ; 
} 
} 
OCStackResult createResourcel () 
{ 
// 资 源 的 URL 
std::string resourceURI = "/a/lighti"; 
// 资 源 类 型 名 称 .在 此 是 指 Light 
std: :string resourceTypeName = "core.light"; 
// 资 源 接口 
std: :string resourceInterface = DEFAULT INTERFACE; 
// 资 源 属性 定义 在 ocstack. h 
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uint8 t resourceProperty; 
if(isSecure) 
{ 
resourceProperty = OC DISCOVERABLE | OC OBSERVABLE | OC SECURE; 
} 
else 
{ 
resourceProperty = OC DISCOVERABLE | OC OBSERVABLE; 
) 


EntityHandler cb = std::bind(&LightResource::entityHandler, this,PH:: . 


OCResourceHandle resHandle; 

// 此 API 会 在 内 部 创建 和 注册 资源 

OCStackResult result = OCPlatform: :registerResource( 
resHandle, resourceURI, resourceTypeName, 
resourceInterface, cb, resourceProperty); 

if (OC STACK OK != result) 

{ 

cout << "Resource creation was unsuccessful\n" ; 


) 


return result; 


OCResourceHandle getHandle() 


{ 
) 


return m resourceHandle; 


//put 资源 表示 

// 从 资源 表示 中 获取 数据 

// 以 及 更 新 内 部 状态 

void put(OCRepresentation& rep) 


{ 


try { 
if (rep. getValue("state", m state)) 
f 
cout << "\t\t\t\t" << "state: " << m_state << endl; 
} 
else 


t 


1); 


cout << "\t\t\t\t" << "state not found in the representation" << endl; 


} 
if (rep. getValue("power", m power)) 
{ 
cout << "\t\t\t\t" << "power: " << m_power << endl; 
} 
else 


{ 


cout << "\t\t\t\t" << "power not found in the representation" << endl; 


} 
} 
catch (exception& e) 
| 
cout << e. what() << endl; 


} 


//post 资源 表示 
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//post 可 以 创建 新 的 资源 或 者 简单 地 扮演 put 的 角色 
// 从 资源 表示 中 获取 数据 
// 以 及 更 新 内 部 状态 
OCRepresentation post(OCRepresentation& rep) 
{ 
static int first = 1; 
// 第 一 次 尝试 创建 资源 时 
if(first) 
{ 
first = 0; 
if(OC_STACK_OK == createResourcel()) 
{ 
OCRepresentation repl; 
repl.setValue("createduri", std::string("/a/lightl")); 
return repl; 
i 
) 
// 从 第 二 次 起 只 执行 put 操作 
put(rep); 
return get() ; 
) 
// 获 取 更 新 的 资源 表示 
// 在 发 送 之 前 更 新 最 新 的 内 部 状态 的 表示 
OCRepresentation get() 
{ 
m lightRep. setValue("state", m state); 
m lightRep. setValue("power", m power); 
return m lightRep; 


) 


void addType(const std::string& type) const 
{ 
OCStackResult result = OCPlatform: :bindTypeToResource(m_resourceHandle, type); 
if (OC STACK OK != result) 
f 
cout << "Binding TypeName to Resource was unsuccessful\n"; 
} 
} 
void addInterface(const std::string& interface) const 
{ 
OCStackResult result = OCPlatform::bindInterfaceToResource(m resourceHandle, interface); 
if (OC STACK OK != result) 
t 
cout << "Binding TypeName to Resource was unsuccessful" ; 
} 
} 
private: 
// 这 是 简单 处 理 句 柄 的 实现 
// 处 理 句 柄 可 以 人 为 地 以 多 种 方式 实现 
OCEntityHandlerResult entityHandler(std::shared ptr < OCResourceRequest > request) 
t 
cout << "\tIn Server CPP entity handler: Vn"; 
OCEntityHandlerResult ehResult = OC EH ERROR; 
if(request) 


3i 
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// 获 取 资 源 类 型 和 请 求 标志 
std::string requestType = request 一 > getRequestType( ) ; 
int requestFlag = request — > getRequestHandlerFlag( ) ; 
if(requestFlag & RequestHandlerFlag: :RequestFlag) 
t 
cout << "\t\trequestFlag : Request\n"; 
auto pResponse = std: :make_shared< 0C: :0CResourceResponse >() ; 
pResponse - > setRequestHandle( request - > getRequestHandle()) ; 
pResponse — > setResourceHandle( request - > getResourceHandle( ) ) ; 
// 检 查 查询 参数 (如 果 有 的 话 ) 
QueryParamsMap queries = request - > getQueryParameters() ; 
if (!queries. empty()) 
t 
Std: :cout << "AnQuery processing upto entityHandler" << std::endl; 
) 
for (auto it : queries) 


{ 


Std: :cout << "Query key: " << it. first <<" value : "<< it. second << std: : 


} 
// 请 求 类 型 是 GET 
if(requestType == "GET" ) 
{ 
cout << "\t\t\trequestType : GET\n"; 
if ( isSlowResponse) // 慢 响应 的 情况 
{ 
static int startedThread = 0; 
if(!startedThread) 
{ 
std: :thread t(handleSlowResponse, (void * )this, request); 
startedThread = 1; 
t.detach(); 
) 
ehResult - OC EH SLOW; 
) 
else // 一 般 响应 的 情况 
{ 
pResponse - > setErrorCode(200) ; 
pResponse - > setResponseResult(OC EH OK); 
pResponse - » setResourceRepresentation(get()); 
if(OC STACK OK == OCPlatform: : sendResponse(pResponse) ) 
{ 
ehResult = OC_EH_OK; 
H 
) 
) 
else if(requestType == "PUT") 
{ 
cout << "\t\t\trequestType : PUT\n"; 
OCRepresentation rep = request — > getResourceRepresentat ion( ) ; 
// 执 行 与 put 请 求 相关 的 操作 
// 更 新 light 资源 
put(rep); 
pResponse - > setErrorCode(200) ; 


endl; 
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pResponse — > setResponseResult(0C EH OK); 
pResponse - > setResourceRepresentation(get()) ; 
if(0C STACK OK == OCPlatform::sendResponse(pResponse) ) 
{ 
ehResult = OC EH OK; 


) 
else if(requestType -- "POST") 
{ 
cout << "\t\t\trequestType : POST\n"; 
OCRepresentation rep = request - > getResourceRepresentation(); 
// 执 行 与 POST 请 求 相关 的 操作 
OCRepresentation rep post = post(rep); 
pResponse - > setResourceRepresentation(rep post); 
pResponse - > setErrorCode(200) ; 
if(rep post. hasAttribute("createduri")) 
t 
pResponse - > setResponseResult(0C EH RESOURCE CREATED); pResponse - > setNewResourceUri 
(rep. post. getValue < std: :string»("createduri")); 


) 
else 
{ 
pResponse - > setResponseResult(OC EH OK); 
) 
if(OC STACK OK == OCPlatform: : sendResponse(pResponse) ) 
{ 
ehResult = OC EH OK; 
) 


} 
else if(requestType == "DELETE") 
{ 


cout << "Delete request received" << endl; 


} 
if(requestFlag & RequestHandlerFlag: :ObserverFlag) 
{ 
ObservationInfo observationInfo = request — > getObservationInfo( ) ; 
if(ObserveAction::ObserveRegister == observationInfo. action) 
{ 
m interestedObservers.push back(observationInfo. obsId) ; 
E 
else if(ObserveAction::ObserveUnregister == observationInfo.action) 
{ 
m interestedObservers. erase(std::remove(m interestedObservers.begin(),m | 
interestedObservers. end() , observationInfo.obsId),m interestedObservers. end()); 
) 
pthread t threadId; 
cout << "\t\trequestFlag : Observer\n"; 
gObservation = 1; 
static int startedThread - 0; 
// 在 ChangeLightRepresentation 函数 中 观察 操作 发 生 在 不 同 的 线程 中 
// 如 果 我 们 还 没 创建 线程 ,将 在 这 创建 一 个 
if(!startedThread) 
{ 
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pthread create (&threadId, NULL, ChangeLightRepresentation, (void * )this); 
startedThread = 1; 

} 

ehResult = OC EH OK; 


) 
else 
t 
std::cout << "Request invalid" << std::endl; 
} 
return ehResult; 
} 
l; 
//ChangeLightRepresentaion 是 观察 函数 
// 用 于 通过 notifyObservers 向 协议 栈 通知 资源 的 任何 变化 
void * ChangeLightRepresentation (void * param) 
{ 
LightResource * lightPtr = (LightResource * ) param; 
// 此 函数 持续 监视 变化 
while (1) 
{ 
sleep (3); 
if (gObservation) 
{ 
// 如 果 在 观察 操作 中 ,1ight 资源 发 生 任何 变化 
// 将 调用 notifyObservors 
// 为 了 演示 ,改变 功率 值 并 通知 变化 
lightPtr-» m power += 10; 
cout << "\nPower updated to : " << lightPtr- » m power << endl; 
cout << "Notifying observers with resource handle: " << lightPtr - > getHandle() << endl; 
OCStackResult result = OC_STACK_OK; 
if(isListOfObservers) 
E 
std: : shared_ptr < OCResourceResponse > resourceResponse = (std::make shared 
< OCResourceResponse >( ) ) ; 
resourceResponse — > setErrorCode(200) ; 
resourceResponse — > setResourceRepresentation(lightPtr- > get(), DEFAULT INTERFACE); 
result = OCPlatform:: notifyListOfObservers ( lightPtr - > getHandle( ), lightPtr - > m_ 
interestedObservers, resourceResponse) ; 
} 
else 
{ 
result = OCPlatform::notifyAllObservers(lightPtr — > getHandle()); 
} 
if(OC_STACK_NO_OBSERVERS == result) 
{ 
cout << "No More observers, stopping notifications" << endl; 
gObservation = 0; 


} 
return NULL; 


} 
void + handleSlowResponse (void * param, std: :shared_ptr < OCResourceRequest > pRequest) 
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// 此 函数 处 理 慢 响应 的 情况 
LightResource* lightPtr = (LightResource * ) param; 
// 通 过 使 用 sleep 诱导 慢 响应 的 情况 
Std: :cout << "SLOW response" << std: :endl; 
sleep (10); 
auto pResponse = std::make shared < OC: :0CResourceResponse >( ) ; 
pResponse — > setRequestHandle(pRequest 一 > getRequestHandle()); 
pResponse - > setResourceHandle(pRequest — > getResourceHandle()) ; 
pResponse - > setResourceRepresentation(lightPtr -> get()); 
pResponse - > setErrorCode(200) ; 
pResponse — > setResponseResult(OC EH OK); 
// 设 置 慢 响应 标志 变 回 false 
isSlowResponse = false; 
OCPlatforn: : sendResponse( pResponse) ; 
return NULL; 

) 

void PrintUsage() 

{ 
std: :cout << std::endl; 
std::cout << "Usage : simpleserver < value >\n"; 
std 
std 
std::cout <<" 2 — Secure resource and notify all observers\n"; 
std::cout <<" 3 - Secure resource and notify list of observers\n\n"; 





std::cout <<" 4 — Non- secure resource, GET slow response, notify all observers\n"; 


} 
static FILE* client open(const char* /* path*/, const char * mode) 
{ 
return fopen(SVR DB FILE NAME, mode); 
} 
int main(int argc, char * argv[]) 
{ 
PrintUsage(); 
OCPersistentStorage ps (client open, fread, fwrite, fclose, unlink }; 
if (argc == 1) 
{ 
isListOfObservers = false; 
isSecure = false; 
) 
else if (argc -- 2) 
{ 
int value = atoi(argv[1]); 
switch (value) 


{ 


case 1: 
isListOfObservers - true; 
isSecure = false; 
break; 

case 2: 


isListOfObservers - false; 
isSecure - true; 
break; 

case 3: 


cout <<" Default — Non- secure resource and notify all observers\n"; 
cout <<" 1 - Non- secure resource and notify list of observers\n\n"; 


Ip 311 
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isListOfObservers = true; 
isSecure - true; 
break; 
case 4: 
isSlowResponse - true; 
break; 
default: 
break; 
} 
} 


else 
{ 
return -1; 
} 
// 创 建 PlatformConfig 对 象 
PlatformConfig cfg ( 
OC: :ServiceType: : InProc, 
OC: :ModeType: :Server, 
"0.0.0.0", // 通 过 设置 为 "0.0.0.0" 来 绑 定 所 有 可 用 的 接口 
0, // 使 用 随机 的 可 用 端口 
OC: :QualityOfService: :LowQos, 
&ps 
i 
OCPlatforn: :Conf igure(cfg) ; 
try 
{ 
// 创 建 资 源 类 的 实例 (在 此 是 'LightResource ' 类 的 实例 ) 
LightResource myLight; 
// 调 用 light 类 的 createResource 函数 
myLight.createResource(); 
std: :cout << "Created resource." << std: :endl; 
myLight. addType(std: : string("core. brightlight")); 
myLight.addInterface(std::string(LINK INTERFACE)); 
Std: :cout «« "Added Interface and Type" «« std: :endl; 
// 条 件 变量 将 释放 给 定 的 互 斥 量 ,然后 执行 非 密 集 型 块 , 直到 调用 notify 
// 在 这 种 情况 下 , 因为 我 们 没有 调用 cv. notify 
// 这 应 该 是 一 个 非 处 理 器 密集 型 版 本 的 while(true) 
std: :mutex blocker; 
std::condition variable cv; 
ique lock« std: :mutex > lock(blocker); 
Std: :cout ««"Waiting" << std: :endl; 
cv.wait(lock, [](return false;]); 
) 
catch(OCException &e) 
{ 
std::cout << "OCException in main : " << e. what() << endl; 
} 
// 没 有 明确 的 调用 停止 程序 
// 当 OCPlatforn: :destructor 被 调用 时 ,将 在 内 部 做 程序 清理 


return 0; 
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2. simpleclient. cpp 


# include < string» 
# include < nap» 
include < cstdlib» 
# include < pthread. h> 
# include < mutex > 
# include < condition_variable> 
# include "OCPlatform. h" 
# include "OCApi. h" 
# define maxSequenceNumber OxFFFFFF 
using namespace OC; 
static const char * SVR DB FILE NAME - "./oic svr db client.dat"; 
typedef std: :map < OCResourceldentifier, std::shared ptr < OCResource >> DiscoveredResourceMap; 
DiscoveredResourceMap discoveredResources; 
std: : shared_ptr < OCResource > curResource; 
static ObserveType OBSERVE TYPE TO USE = ObserveType: :Observe; 
std: :mutex curResourceLock; 
class Light 
{ 
public: 
bool m_state; 
int m_power; 
std::string m name; 
Light() : m state(false), m power(0), m name("") 
{ 





hi 
Light mylight; 
int observe_count() 
{ 
static int oc = 0; 
return **oc; 
) 
void onObserve (const HeaderOptions / * headerOptions * /, const OCRepresentation& rep, const int& eCode, 
const int& sequenceNunber ) 
{ 
try 
{ 
if(eCode == OC_STACK_OK && sequenceNumber != maxSequenceNumber + 1) 
t 
if(sequenceNumber -- OC OBSERVE REGISTER) 
{ 
std: :cout << "Observe registration action is successful" << std: :endl; 
} 
std: :cout << "OBSERVE RESULT: "<< std: :endl; 
std: :cout << "\tSequenceNumber: "<< sequenceNumber << std: : endl; 
rep. getValue("state", mylight.m_state); 
rep. getValue( "power", mylight.m power); 
rep.getValue("name", mylight.m name); 
std: :cout << "\tstate: " << nylight.m state << std: :endl; 
std: :cout << "\tpower: " << mylight.m power << std::endl; 
std: :cout << "\tname: " << mylight.m name << std: :endl; 
if(observe_count() == 11) 


























314 «|| OCF 技 术 原 理 及 物 联网 程序 开发 指南 





{ 
std: :cout <<"Cancelling Observe. . . "<< std: :endl; 
OCStackResult result = curResource 一 > cancelObserve(); 
std: :cout << "Cancel result: "<< result << std: :endl ; 
sleep(10); 
Std: :cout << "DONE"«« std: :endl; 
::exit(0); 
) 
) 
else 
t 
if(eCode -- OC STACK OK) 
{ 
std::cout << "Observe registration failed or de - registration action failed/succeeded" << 
std::endl; 


else 

{ 
std: :cout << "onObserve Response error: " << eCode << std::endl; 
std: :exit( - 1); 


) 
catch(std: :exception& e) 
{ 


std::cout << "Exception: " << e. what() <<" in onObserve" << std::endl; 


} 
void onPost2(const HeaderOptions& / * headerOptions * /, 
const OCRepresentation& rep, const int eCode) 
{ 
try 
{ 
if(eCode == OC_STACK_OK || eCode == OC_STACK_RESOURCE_CREATED 
|| eCode == OC_STACK_RESOURCE_CHANGED) 


std: :cout << "POST request was successful" << std: :endl; 
if (rep. hasAttribute("createduri")) 
t 
Std: :cout << "\tUri of the created resource: " 
<< rep. getValue< std: :string>("createduri") << std::endl; 
} 
else 
{ 
rep. getValue("state", mylight.m state); 
rep. getValue("power", mylight. m_power) ; 
rep. getValue("name", mylight.m name); 
std::cout << "\tstate: " << mylight.m state << std::endl; 
cout << "\tpower: " << mylight.m power << std::endl; 
::cout << "\tname: " << mylight.m name << std::endl; 












sti 
} 
if (OBSERVE_TYPE_TO_USE == ObserveType: :Observe) 

Std: :cout << std: :endl << "Observe is used." << std: :endl << std::endl; 
else if (OBSERVE TYPE TO USE == ObserveType: :ObserveAl1) 
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Std: :cout << std: :endl << "ObserveAll is used." << std: :endl << std::endl; 
curResource — > observe(OBSERVE TYPE TO USE, QueryParamsMap(), &onObserve); 
) 
else 
t 
std: :cout << "onPost2 Response error: " << eCode << std::endl; 
std::exit( - 1); 





catch(std: :exception& e) 
{ 
std: :cout << "Exception: " << e. what() <<" in onPost2" << std::endl; 
} 
} 
void onPost(const HeaderOptions& / * headerOptions * /, const OCRepresentation& rep, const int eCode) 
t 
try 
{ 
if(eCode == OC STACK OK || eCode == OC STACK RESOURCE CREATED 
|| eCode == OC STACK RESOURCE CHANGED) 








std: :cout << "POST request was successful" << std: :endl; 
if (rep. hasAttribute("createduri")) 
{ 
std: :cout << "\tUri of the created resource: " 
<< rep. getValue < std: :string»("createduri") << std::endl; 
) 
else 
{ 
rep. getValue("state", mylight.m state); 
rep. getValue( "power", nylight.m power); 
rep. getValue( "name", mylight.m name); 
std: :cout << "\tstate: " << mylight.m_state << std: :endl; 
std: :cout << "\tpower: " << nylight.m power << std::endl; 
std: :cout << "\tname: " << mylight.m name << std: :endl; 
} 
OCRepresentation rep2; 
std: :cout << "Posting light representation..."«« std::endl; 
mylight.m state = true; 
mylight.m power = 55; 
rep2.setValue("state", mylight.m state); 
rep2. setValue("power", mylight.m power); 
curResource -> post(rep2, QueryParamsMap(), &onPost2); 












) 

else 

t 
std: :cout << "onPost Response error: " << eCode << std::endl; 
std::exit( - 1); 


) 
catch(std: :exception& e) 
{ 
std: :cout << "Exception: " << e. what() <<" in onPost" << std::endl; 
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} 


// 局 部 函数 ,用 于 给 资源 put 不 同 的 状态 
void postLightRepresentation( std: :shared_ptr < OCResource > resource) 


{ 


if(resource) 


{ 


} 
} 


OCRepresentation rep; 

std: :cout << "Posting light representation. . . "<< std::endl; 
mylight.m_state = false; 

mylight.m_power = 105; 

rep. setValue("state", mylight.m state); 
rep.setValue("power", mylight.m power); 

// f FA rep, query nap 和 回调 参数 调用 资源 的 POST API 
resource -> post(rep, QueryParamsMap(), &onPost); 











// 对 put 请 求 的 回调 句柄 
void onPut(const HeaderOptions& / * headerOptions * /, const OCRepresentation& rep, const int eCode) 
{ 
try 
{ 
if (eCode == OC_STACK_OK || eCode == OC_STACK_RESOURCE_CHANGED) 
{ 
std: :cout << "PUT request was successful" << std::endl; 
rep. getValue("state", mylight.m state); 
rep. getValue("power", mylight.m_power) ; 
rep. getValue("name", mylight.m_name) ; 
std::cout << "\tstate: " << mylight.m_state << std::endl; 
std::cout << "\tpower: " << mylight.m_power << std::endl; 
std::cout << "\tname: " << nylight.m name << std::endl; 
postLightRepresentat ion(curResource) ; 
} 
else 


} 


{ 


std: :cout << "onPut Response error: " << eCode << std: : endl; 
std::exit( - 1); 


catch(std: :exception& e) 


{ 


) 
) 


std: :cout << "Exception: " << e. what() <<" in onPut" << std::endl; 


// 局 部 函数 ,用 于 给 资源 put 不 同 的 状态 
void putLightRepresentation( std: :shared_ptr< OCResource > resource) 


{ 


if (resource) 


{ 


OCRepresentation rep; 

std: :cout << "Putting light representation. .. "<< std::endl; 
mylight.m_state = true; 

mylight.m_power = 15; 

rep. setValue("state", mylight.m state); 

rep. setValue("power", mylight.m power); 
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// 使 用 rep,query nap 和 回调 参数 调用 资源 的 POST API 
resource 一 > put(rep, QueryParamsMap(), &onPut); 
) 
// 对 GET 请 求 的 回调 句柄 
void onGet(const HeaderOptions& / * headerOptions * /, const OCRepresentation& rep, const int eCode) 
{ 
try 
{ 
if(eCode == OC_STACK_OK) 
t 
Std::cout «« "GET request was successful" «« std: :endl; 
std: :cout << "Resource URI: " << rep.getUri() << std::endl; 
rep. getValue("state", nylight.m state); 
rep. getValue("power", mylight.m power); 
rep. getValue("name", nylight.m name); 
cout << "\tstate: " << mylight.m state << std: :endl; 
std::cout << "\tpower: " << mylight.m power << std::endl; 
cout << "\tname: " << mylight.m name << std::endl; 
putLightRepresentat ion(curResource) ; 











) 


else 


{ 


std: :cout << "onGET Response error: " << eCode << std::endl; 
std: :exit( - 1); 


) 
catch(std: :exception& e) 
{ 
std: :cout << "Exception: " << e. what() <<" in onGet" << std::endl; 
) 
) 
// 局 部 函数 ,用 于 获取 Light 资源 的 表示 


void getLightRepresentation( std: :shared_ptr < OCResource > resource) 


{ 
if(resource) 
{ 
std: :cout << "Getting Light Representation. . . "<< std: :endl; 
// 使 用 回调 参数 调用 资源 的 GET API 
QueryParamsMap test; 
resource 一 > get(test, &onGet); 
) 
) 
// 回 调 发 现 资源 
void foundResource( std: : shared_ptr < OCResource > resource) 
{ 
cout << "In foundResource\n"; 
string resourceURI; 
std::string hostAddress; 





std: :lock guard« std: :mutex > lock(curResourceLock) ; 
if (discoveredResources. find(resource — > uniqueldentifier()) == discoveredResources. end()) 
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Std: :cout «« "Found resource " << resource - » uniqueIdentifier() «« 
" for the first time on server with ID: "<< resource - > sid()«« std::endl; 
discoveredResources[resource -» uniqueIdentifier()] = resource; 
) 
else 
{ 
std: :cout ««"Found resource "<< resource - > uniqueIdentifier() «« " again!"<< std: :endl; 
) 
if(curResource) 
* 
std::cout << "Found another resource, ignoring"«« std::endl; 
return; 
} 
} 
// 对 资源 对 象 执行 操作 
if(resource) 
{ 
std: :cout <<"DISCOVERED Resource: "«« std: :endl; 
// 获 取 资 源 URI 
resourceURI = resource- »uri(); 
Std: :cout << "\tURI of the resource: " << resourceURI << std::endl; 
// 获 取 资 源 主机 地 址 
hostAddress = resource -> host(); 
std: :cout << "\tHost address of the resource: " << hostAddress << std: :endl; 
// 获 取 资 源 类 型 
std::cout << "AtList of resource types: " << std::endl; 
for(auto &resourceTypes : resource - > getResourceTypes() ) 
{ 
std: :cout << "\t\t" << resourceTypes << std::endl; 
} 
// 获 取 资 源 接 口 
std::cout << "\tList of resource interfaces: " << std::endl; 
for(auto &resourceInterfaces : resource - > getResourceInterfaces()) 
{ 
std: :cout << "\t\t" << resourceInterfaces << std::endl; 
} 
if (resourceURI 
{ 
curResource = resource; 
// 调 用 一 个 局 部 函数 , 它 将 在 内 部 调用 对 资源 指针 的 GET API 


getLightRepresentation( resource); 





"/a/light") 


} 


else 
{ 
// 资 源 是 无 效 的 


std: :cout << "Resource is invalid" << std::endl; 


} 
catch(std: :exception& e) 
{ 


std: :cerr << "Exception in foundResource: "<< e. what() << std::endl; 
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) 
void printUsage() 


{ 





std: :cout << std::endl; 
std: :cout << "一 
std: :cout << "Usage : simpleclient < ObserveType >" << std::endl; 
std::cout << " ObserveType : 1 — Observe" << std::endl; 

std: :cout «« " ObserveType : 2 — ObserveAll" << std::endl; 
std:: 














) 
void checkObserverValue(int value) 


{ 
if (value == 1) 
{ 
OBSERVE_TYPE_TO_USE = ObserveType: :Observe; 
std: :cout << " 





} 


else if (value 


{ 





OBSERVE TYPE TO USE = ObserveType: :ObserveAll; 
Std: :cout << "< === Setting ObserveType to ObserveAll === >\n\n"; 
} 


else 


{ 





Std: :cout << "<=== Invalid ObserveType selected. " 
««" Setting ObserveType to Observe >\n\n"; 
} 





} 
static FILE* client open(const char* /* path*/, const char * mode) 
{ 
return fopen(SVR DB FILE NAME, mode); 
} 
int main(int argc, char * argv[]) { 
std: :ostringstream requestURI; 
OCPersistentStorage ps (client open, fread, fwrite, fclose, unlink }; 
try 
{ 
printUsage(); 
if (argc == 1) 
t 





std: :cout <<" 
) 
else if (arge == 2) 
{ 

checkObserverValue( std: :stoi(argv[1])); 





= Setting ObserveType to Observe and ConnectivityType to IP 


>\n\n"; 





catch(std: :exception& ) 
{ 
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std: :cout << "< === Invalid input arguments ===>\n\n"; 
return -1; 
) 
// 创 建 PlatformConfig 对 象 
PlatformConfig cfg ( 
OC: :ServiceType: : InProc, 
OC: :ModeType: : Both, 
"0.0.0.0", 
0, 
OC: :QualityOfService: :HighQos, 
&ps 
}; 
OCPlatform: :Configure( cfg); 
try 
{ 
// 使 得 所 有 布尔 值 在 此 流 中 打印 为 true/false 
Std: :cout. setf (std: : ios: :boolalpha); 
// 找 到 所 有 资源 
requestURI << OC RSRVD WELL KNOWN URI; //<< "?rt = core. light"; 
OCPlatforn::findResource("", requestURI. str(), 
CT DEFAULT, &foundResource); 
Std: :cout << "Finding Resource... " << std::endl; 
// 查 找 资 源 完成 两 次 ,以便 我 们 第 二 次 发 现 原始 资源 
// 这 些 资源 将 具有 相同 的 uniqueidentifier( 仍 然 是 不 同 的 对 象 ) 
// 以 便 我 们 可 以 在 foundResource( 上 面 ) 中 验证 /显示 重复 检查 代码 
OCPlatform: :findResource(""，requestURI. str(), 
CT DEFAULT, &foundResource); 
Std: :cout «« "Finding Resource for second time..." «« std: :endl; 
// 条 件 变量 将 释放 给 定 的 互 斥 量 ,然后 执行 非 密集 型 块 ,直到 调用 notify 
// 在 这 种 情况 下 ,因为 没有 调用 cv. notify 
// 这 应 该 是 一 个 非 处 理 器 密集 型 版 本 的 while(true) 
std: :mutex blocker; 
std::condition variable cv; 
std: :unique_lock < std: :mutex > lock(blocker); 
cv. wait( lock) ; 
}eatch( OCException& e) 
{ 
oclog() << "Exception in main: "<< e. what(); 
} 
return 0; 


} 


12.4 BF Android 的 开发 方法 


lotivity 的 Android 代码 在 Linux 系统 下 编译 ,环境 配置 参考 12. 3 节 。 


12.4.1 软件 工具 的 安装 


软件 安装 步骤 如 下 。 
(D JDK, 


$ sudo apt- get update 
$ sudo apt- get install openjdk - 7 - jdk 
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(2) Android SDK,NDK 和 Gradle. 下 载 地 址 如 表 12-1 所 示 。 
表 12-1 软件 下 载 地 址 














软 fF 下 载 地 址 
Android NDK http://developer. android. com/tools/sdk/ndk/index. html 
Android SDK http: //developer. android. com/sdk/index. html 
Gradle https: //services. gradle. org/distributions/gradle-2. 2. 1-all. zip 








(3) 配置 系统 变量 。 


ANDROID NDK = < path to android ndk> 

ANDROID HOME = < path to android sdk > 

GRADLE HOME - « path to gradle/bin» 

配置 完 系 统 变量 之 后 如 图 12-13 Bros 
export ANDROID NDK-/home/tanyang/Downloads/OCF/iotivity-1.1.1/extlibs/ 
android/ndk/android-ndk-r1ed 
export PATH-SANDROID NDK:$PATH 
export ANDROID HOME-/home/tanyang/Downloads/OCF/iotivity-1.1.1/extlibs/ 
android/sdk/android-sdk-linux 
export PATH-SANDROID HOME/tools:SANDROID HOME/platform-tools:SPATH 
export GRADLE HOME-/home/tanyang/Downloads/OCF/iotivity-1.1.1/extlibs/ 


androtd/gradle/gradle-2.2.1 
export PATH-SGRADLE HOME/bin:SPATH 


图 12-13 配置 变量 后 


12.4.2 Android 环境 下 的 编译 方法 
编译 方法 如 下 。 
OD 编译 指令 。 


Scons TARGET OS = android TARGET ARCH = < target arch > TARGET TRANSPORT = < target transport > RELEASE = < 
release mode > SECURED = < secure > ANDROID HOME = < path to android SDK > ANDROID NDK = < path to android NDK > 
GRADLE HOME - « path to gradle/bin» 


(2) 编译 选项 。 
编译 选项 如 表 12-2 所 示 。 
表 12-2 编译 选项 





x86 (默认 ) 
x86_64 


armeabi 








支持 的 架构 





armeabi-v7a 





所 有 (默认 ) 
IP 

蓝牙 
低 功 耗 蓝牙 





支持 的 传输 类 型 
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(2) Android SDK,NDK 和 Gradle. 下 载 地 址 如 表 12-1 所 示 。 
表 12-1 软件 下 载 地 址 














软 fF 下 载 地 址 
Android NDK http://developer. android. com/tools/sdk/ndk/index. html 
Android SDK http: //developer. android. com/sdk/index. html 
Gradle https: //services. gradle. org/distributions/gradle-2. 2. 1-all. zip 








(3) 配置 系统 变量 。 


ANDROID NDK = < path to android ndk> 

ANDROID HOME = < path to android sdk > 

GRADLE HOME - « path to gradle/bin» 

配置 完 系 统 变量 之 后 如 图 12-13 Bros 
export ANDROID NDK-/home/tanyang/Downloads/OCF/iotivity-1.1.1/extlibs/ 
android/ndk/android-ndk-r1ed 
export PATH-SANDROID NDK:$PATH 
export ANDROID HOME-/home/tanyang/Downloads/OCF/iotivity-1.1.1/extlibs/ 
android/sdk/android-sdk-linux 
export PATH-SANDROID HOME/tools:SANDROID HOME/platform-tools:SPATH 
export GRADLE HOME-/home/tanyang/Downloads/OCF/iotivity-1.1.1/extlibs/ 


androtd/gradle/gradle-2.2.1 
export PATH-SGRADLE HOME/bin:SPATH 


图 12-13 配置 变量 后 


12.4.2 Android 环境 下 的 编译 方法 
编译 方法 如 下 。 
OD 编译 指令 。 


Scons TARGET OS = android TARGET ARCH = < target arch > TARGET TRANSPORT = < target transport > RELEASE = < 
release mode > SECURED = < secure > ANDROID HOME = < path to android SDK > ANDROID NDK = < path to android NDK > 
GRADLE HOME - « path to gradle/bin» 


(2) 编译 选项 。 
编译 选项 如 表 12-2 所 示 。 
表 12-2 编译 选项 





x86 (默认 ) 
x86_64 


armeabi 








支持 的 架构 





armeabi-v7a 





所 有 (默认 ) 
IP 

蓝牙 
低 功 耗 蓝牙 





支持 的 传输 类 型 
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续 表 
1 GRA BUD 
HERTS 0 《调试 模式 ) 
是 否 DTLS (数据 传输 层 安全 ) DEM 








IoTivity Base Android API €. aar file) 输 出 目录 : < iotivity >/android/android_api/base/build/ 
outputs/aar/iotivity-base-« your arch >< release mode >. aar. 

(3) 运行 samples, 

sample APK EH 3: < iotivity >/android/examples/< example name >/build/outputs/apk/ 
< example name >-< release mode >. apk, 

下 载 Android APP Æ Android 终端 $adb install < iotivity >/android/examples/< example _ 


name >/build/outputs/apk/< apk name >. 


12.4.3 APP 实例 


APP 的 运行 步骤 如 下 。 

(1) simpleclient 和 simpleserver 的 应 用 程序 界面 如 图 12-14 所 示 。 

(2) 点 击 simpleserver 应 用 程序 中 的 START 按钮 ,应 用 程序 会 创建 一 个 light 虚拟 资源 ,如 图 12-15 
所 示 。 


Simple Client Simple Server Simple Server 


Configuring platform. 
Creating a light 

URI: /a/light 

name: Johns light 

state: false 

power: 0 

Registering light as a resource 
Waiting for the requests. 


lativity  i&Tivity — gTivity 


(3) 点 击 simpleclient 应 用 程序 中 的 START 按钮 .可 以 看 到 ,客户 端 发 现 了 服务 器 端 创建 的 资源 
并 将 其 表示 打印 了 出 来 ,如 图 12-16 所 示 。 
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Simple Client Simple Client 
TA 
fedf:6729):43457 

Configuring platform. List of resource types: 

Finding all resources of type "core light core light 

Found resource for the first time on server with ID: List of resource interfaces: 
47e900e0-bc62-45e4-906a-dba8816d5b42 oic if baseline. 

URI of the resource: /a/ight List of resource connectivity types: 

Host address of the resource: coap /lfe80-3abc-1aff CT_ADAPTERIP 





fodf:6729):44468 
List of resource types: = = 
core light Getting Light Representation. 











List of resource interfaces: Finding all resources of type “core light" for the second. 
oicif baseline time 
List of resource connectivity types: 一 
CT. ADAPTER. IP und a previously seen resource again! 
CT.IP. USE V6 Found another resource, ignoring 
一 -一 - — GET request was successful 
Getting Light Representation, Resource URI: /a/light 








Finding all resources of type "core light" for the second Light attributes: 
name: Johns light 
-一 一 一 一 一 一 一 一 state: false 
Found a previously seen resource again! power: 0 


STivity t@Tivity 


图 12-16 资源 创建 完成 





12.4.4 实例 代码 


Android 端的 示例 以 simpleclient 和 simpleserver 为 例 。 这 两 个 示例 位 于 ioticity 工程 的 android/ 
examples 目录 下 。 

1. simpleclient 

该 工程 中 主要 包含 两 个 Java 文件 ,分 别 为 Light. java 和 SimpleClient. java. 

1) Light. java 文件 中 的 代码 


package org. iotivity. base. examples; 
import org. iotivity. base. OcException; 
import org. iotivity.base. OcRepresentation; 
/ * Light, 该 类 创建 了 一 个 远程 灯 资源 的 对 象 表示 ,并 根据 服务 器 端的 响应 更 新 相应 的 值 * / 
public class Light { 
public static final String NAME KEY = "name"; 
public static final String STATE KEY - "state"; 
public static final String POWER KEY = "power"; 
private String mName; 
private boolean nState; 
private int mPower; 


public Light() ( 


mName - ""; 
mState = false; 
mPower = 0; 


) 

public void setOcRepresentation(OcRepresentation rep) throws OcException ( 
mName - rep.getValue(NAME KEY); 
mState = rep. getValue(Light. STATE KEY); 
mPower = rep. getValue(Light.POWER_KEY) ; 
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public OcRepresentation getOcRepresentation() throws OcException { 


OcRepresentation rep 7 new OcRepresentation(); 
rep.setValue(NAME KEY, mName); 
rep.setValue(STATE KEY, mState) ; 
rep.setValue(POWER KEY, mPower); 
return rep; 

} 

public String getName() { 
return mName; 

} 

public void setName(String name) { 
this.mName = mName; 

} 

public boolean getState() { 
return mState; 

} 

public void setState(boolean state) { 
this.mState = state; 

} 

public int getPower() { 
return mPower; 

} 

public void setPower(int power) { 
this.mPower = power; 

} 

@override 

public String toString() { 
return "Wt" + NAME KEY + ": " + mName + 

"\n\t" + STATE KEY + ":" + mState + 
"\n\t" + POWER KEY + ": " + mPower; 


} 
2) SimpleClient. java 文件 中 的 代码 


package org. iotivity. base. examples; 

import android. app. Activity; 

import android. content. Context; 

import android. content. Intent; 

import android. nfc. NfcAdapter; 

import android. os. Bundle; 

import android. text. method. ScrollingMovementMethod; 
import android. util.Log; 

import android. view. View; 

import android. widget. Button; 

import android. widget. ScrollView; 

import android. widget. TextView; 

import org. iotivity. base. ErrorCode; 

import org. iotivity. base. ModeType; 

import org. iotivity. base. ObserveType; 

import org. iotivity. base. OcConnect ivityType; 
import org. iotivity. base. OcException; 

import org. iotivity. base. OcHeaderOption; 
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import org. iotivity. base. OcPlatform; 
import org. iotivity. base. OcRepresentation; 
import org. iotivity. base. OcResource; 
import org. iotivity. base. OcResourceIdentifier; 
import org. iotivity. base. PlatformConfig; 
import org. iotivity. base. Qual ityOfService; 
import org. iotivity. base. ServiceType; 
import java.util.EnumSet; 
import java. util. HashMap; 
import java.util.List; 
import java.util.Map; 
/ * SinpleClient 是 一 个 简单 的 客户 端 程序 , 在 simpleServer 开启 之 后 ,该 程序 才 会 被 启动 . 程序 发 现 有 客户 端 广 
播 的 资源 并 且 对 所 发 现 的 资源 进行 不 同 的 操作 (GET，PUT, POST，DELETE 和 OBSERVE) * / 
public class SimpleClient extends Activity implements 
OcPlatform. OnResourceFoundListener, 
OcResource. OnGetListener, 
OcResource. OnPutListener, 
OcResource. OnPostListener, 
OcResource. OnObserveListener ( 
private Map < OcResourceIdentifier, OcResource > mFoundResources = new HashMap «»(); 
private OcResource mFoundLightResource = null; 
//1ocal representation of a server's light resource 
private Light mLight = new Light(); 
/* 一 个 本 地 方法 ,配置 和 初始 化 平台 ,然后 寻找 Light 资源 * / 
private void startSimpleClient() { 
Context context = this; 
PlatformConfig platformConfig = new PlatformConfig( 
this, 
context, 
ServiceType. IN PROC, 
ModeType. CLIENT, 
"0.0.0.0", // 设 置 "0.0.0.0", 绑 定 可 用 接口 
0, // 使 用 随机 可 用 端口 
QualityOfService. LOW 
E 
nsg("Configuring platform."); 
OcPlatform. Conf igure(platformConf ig) ; 
try { 
msg("Finding all resources of type \"core. light\"."); 
String requestUri = OcPlatform.WELL KNOWN QUERY + "?rt = core. light"; 
OcPlatform. findResource("", 
requestUri, 
EnumSet. of (OcConnect ivityType. CT DEFAULT), 
this 
); 
sleep(1); 
/* 寻找 资源 被 执行 了 两 次 ,因此 会 发 现 两 次 资源 . 这 些 资源 会 有 相同 的 唯一 标识 符 ,但 是 不 同 的 对 象 ， 
因此 ,可 以 在 foundResource 中 证 实 或 展现 重复 的 检查 代码 * / 
nsg("Finding all resources of type \"core. light\" for the second time"); 
OcPlatform. findResource("", 
requestUri, 
EnumSet. of (OcConnect ivityType. CT DEFAULT), 
this 
) 


3 
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) catch (OcException e) { 
Log.e(TAG, e. toString()); 
nsg("Failed to invoke find resource API"); 
} 
printLine( ) ; 
} 
/ * 当 一 个 "findResource" 请 求 成 功 之 后 ,会 执行 一 个 事件 处 理 器 @param ocResource found resource * / 
GOverride 
public synchronized void onResourceFound(OcResource ocResource) ( 
if (null == ocResource) { 
msg("Found resource is invalid"); 
return; 
} 
if (mFoundResources. containsKey(ocResource. getUniqueldentifier())) { 
msg("Found a previously seen resource again! "); 
} else { 
nsg("Found resource for the first time on server with ID: " + ocResource. getServerId()); 
mFoundResources. put (ocResource. getUniqueIdentifier(), ocResource) ; 
) 
if (null != mFoundLightResource) { 
msg("Found another resource, ignoring"); 
return; 
) 
// 得 到 资源 的 URI 
String resourceUri = ocResource.getUri(); 
//Get the resource host address 
String hostAddress - ocResource.getHost(); 
msg("\tURI of the resource: " + resourceUri); 
msg("\tHost address of the resource: " + hostAddress); 
// 得 到 资源 的 类 型 
msg("\tList of resource types: "); 
for (String resourceType : ocResource. getResourceTypes()) ( 
msg("\t\t" + resourceType) ; 
} 
msg("\tList of resource interfaces:"); 
for (String resourceInterface : ocResource. getResourceInterfaces()) { 
msg("\t\t" + resourceInterface) ; 
} 
msg("\tList of resource connectivity types:"); 
for (OcConnectivityType connectivityType : ocResource. getConnectivityTypeSet()) ( 
msg("\t\t" + connectivityType) ; 
} 
printLine(); 
// 在 这 个 例子 中 只 有 Light 资源 
if (resourceUri equals("/a/light")) ( 
// 将 资源 引用 分 配给 全 局 变量 使 之 始终 有 效 
// 超 出 范围 时 被 GC 破坏 
mFoundLightResource = ocResource; 
// 调 用 一 个 本 地 方法 ,但 是 该 方法 会 在 内 部 调用 "get"API, 用 于 foundLightResource 
getLightResourceRepresentation( ); 
} 
} 
/* 该 方法 用 于 获取 发 现 的 light 资源 的 表示 * / 
private void getLightResourceRepresentation() { 
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msg("Getting Light Representation..."); 
Map < String, String» queryParams = new HashMap «»(); 
try { 
// 使 用 OcResource. OnGetListener 事件 调用 资源 的 "get"API。 监 听 器 的 实现 
sleep(1); 
nFoundLightResource. get(queryParams, this); 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
nsg("Error occurred while invoking \"get\" API"); 


} 
} 
n 
* 当 一 个 "get" 请 求 完成 之 后 ,会 执行 一 个 事件 监听 器 . 
* (param list 头 选项 列表 
* (param ocRepresentation 资源 的 表示 
*/ 
@override 


public synchronized void onGetCompleted(List < OcHeaderOption> list, 
OcRepresentation ocRepresentation) ( 
nsg("GET request was successful"); 
msg("Resource URI: " * ocRepresentation.getUri()); 
try { 
// 将 属性 值 读 到 一 个 light 的 本 地 表示 中 
mLight. setOcRepresentat ion(ocRepresentation) ; 
} catch (OcException e) { 
Log. e(TAG, e.toString()); 
msg("Failed to read the attributes of a light resource") ; 
} 
msg("Light attributes: "); 
msg(mLight. toString()); 
printLine(); 
// 调 用 一 个 本 地 方法 ,但 是 该 方法 会 在 内 部 调用 "put"API, JH F //foundLightResource. 
putLightRepresentation(); 
) 
mm 
* 当 一 个 "get" 请 求 失败 ,会 执行 下 面 的 事件 处 理 器 
* @param throwable exception 
*/ 
GOverride 
public synchronized void onGetFailed(Throwable throwable) ( 
if (throwable instanceof OcException) ( 
OcException ocEx = (OcException) throwable; 
Log. e(TAG, ocEx. toString()); 
ErrorCode errCode = ocEx.getErrorCode(); 
//do something based on errorCode 
msg("Error code: " + errCode) ; 
} 
msg("Failed to get representation of a found light resource") ; 
} 
/* 本 地 方法 ,为 灯 的 资源 推送 一 个 不 同 状态 * / 
private void putLightRepresentation() ( 
// 设 置 新 的 值 
mLight.setState(true); 
mLight. setPower(15); 


328 «(|| OCF 技 术 原理 及 物 联 网 程序 开发 指南 





msg("Putting light representation..."); 
OcRepresentation representation - null; 
try { 

representation - mLight.getOcRepresentation(); 
} catch (OcException e) ( 

Log. e(TAG, e. toString()); 

msg("Failed to get OcRepresentation from a light"); 
) 
Map < String, String» queryParams = new HashMap «»(); 
try ( 

sleep(1); 

nFoundLightResource. put(representation, queryParams, this); 
} catch (OcException e) ( 

Log. e(TAG, e. toString()); 

nsg("Error occurred while invoking \"put\" API"); 


) 


/* 

* 当 "put" 请 求 成 功 ,会 执行 一 个 事件 处 理 器 
* (param list 头 选 项 列表 

* @param ocRepresentation 一 个 资源 的 表示 
*/ 

@override 


public synchronized void onPutCompleted(List < OcHeaderOption» list, OcRepresentation ocRepresentation) { 
msg("PUT request was successful") ; 
try { 
mLight. setOcRepresentat ion(ocRepresentation) ; 
) catch (OcException e) { 
Log. e(TAG, e. toString()); 
msg("Failed to create Light representation"); 
) 
msg("Light attributes: "); 
msg(mLight. toString()); 
printLine(); 
// 调 用 一 个 本 地 方法 ,但 是 该 方法 会 在 内 部 调用 "post"API, 用 于 foundLightResource 
//postLightRepresentation(); 
/* 当 "put" 请 求 失败 ,会 执行 下 面 的 事件 处 理 器 
* @param throwable exception 
*/ 
@override 
public synchronized void onPutFailed(Throwable throwable) { 
if (throwable instanceof OcException) { 
OcException ocEx = (OcException) throwable; 
Log. e(TAG, ocEx. toString()); 
ErrorCode errCode = ocEx.getErrorCode(); 
// 基 于 错误 代码 做 一 些 事情 
msg("Error code: ”+ errCode); 
) 
msg( "Failed to \"put\" a new representation"); 
} 
/* 为 该 light 资源 发 送 一 个 不 同 的 状态 / 
private void postLightRepresentation() { 
// 设 置 新 值 
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mLight. setState(false) ; 
nLight. setPower(105) ; 
msg("Posting light representation. .."); 
OcRepresentation representation = null; 
try { 
representation = mLight.getOcRepresentation(); 
) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
nsg("Failed to get OcRepresentation from a light"); 
) 
Map< String, String» queryParams = new HashMap <>(); 
try ( 
sleep(1); 
mFoundLightResource. post(representation, queryParams, this); 
) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
msg("Error occurred while invoking \"post\" API"); 
) 
) 
/ * 当 "post" 请 求 成 功 ,会 执行 下 面 的 事件 处 理 器 
* @param list list of the header options 
* (param ocRepresentation 一 个 资源 的 表示 * / 
@override 
public synchronized void onPostCompleted(List <OcHeaderOption> list, 
OcRepresentation ocRepresentation) { 
msg("POST request was successful"); 
try { 
if (ocRepresentat ion. hasAttribute(OcResource. CREATED URI KEY)) { 
msg("\tUri of the created resource: " + 
ocRepresentat ion. get Value(OcResource. CREATED URI KEY)); 
} else { 
mLight. setOcRepresentat ion(ocRepresentat ion) ; 
msg(mLight. toString()); 
} 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
} 
// 设 置 新 的 值 
mLight.setState(true); 
mLight. setPower(55) ; 
msg("Posting again light representation. .."); 
OcRepresentation representation2 = null; 
try { 
representation2 = mLight.getOcRepresentation(); 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
nsg("Failed to get OcRepresentation from a light"); 
} 
Map < String, String» queryParams = new HashMap <>(); 
try { 
mFoundLightResource. post(representation2, queryParams, onPostListener2) ; 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
msg("Error occurred while invoking \"post\" API"); 
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) 
} 
/* 当 "post" 请 求 失败 ,会 执行 下 面 的 事件 处 理 器 
* @param throwable exception * / 
GOverride 
public synchronized void onPostFailed(Throwable throwable) { 
if (throwable instanceof OcException) ( 
OcException ocEx = (OcException) throwable; 
Log. e(TAG, ocEx. toString()); 
ErrorCode errCode = ocEx.getErrorCode(); 
//do something based on errorCode 
msg("Error code: " + errCode); 
) 
nsg("Failed to V'postV" a new representation"); 
} 
/ * 声明 并 实现 第 二 个 OcResource. OnPostListener * / 
OcResource. OnPostListener onPostListener2 = new OcResource. OnPostListener() { 
/ * 当 "post" 请 求 成 功 ,会 执行 下 面 的 事件 处 理 器 
* @param list list of the header options 
* @param ocRepresentation 资源 表示 * / 
@override 
public synchronized void onPostCompleted(List <OcHeaderOption> list, 
OcRepresentation ocRepresentation) ( 
nsg(" Second POST request was successful"); 
try { 
if (ocRepresentation. hasAttribute(OcResource. CREATED URI KEY)) ( 
msg("\tUri of the created resource:" + ocRepresentation. getValue(OcResource. CREATED URI KEY)); 
) else ( 
mLight. setOcRepresentation(ocRepresentation); 
msg(mLight. toString()); 
) 
} catch (OcException e) ( 
Log. e(TAG, e. toString()); 
} 
// 调 用 该 方法 会 间接 调用 foundLightResource 的 observe //API 
observeFoundLightResource(); 
} 
/ * 当 "post" 请 求 失败 ,会 执行 下 面 的 事件 处 理 器 
* @param throwable exception * / 
GOverride 
public synchronized void onPostFailed(Throwable throwable) ( 
if (throwable instanceof OcException) ( 
OcException ocEx = (OcException) throwable; 
Log. e(TAG, ocEx. toString()); 
ErrorCode errCode = ocEx.getErrorCode(); 
//do something based on errorCode 
msg("Error code: " + errCode) ; 
} 
nsg("Failed to \"post\" a new representation"); 
} 
E 
/ * 开始 Observe 该 light 资源 */ 
private void observeFoundLightResource() { 
try { 
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sleep(1); 

nFoundLightResource. observe(ObserveType. OBSERVE, new HashMap < String, String>(), this); 
) catch (OcException e) { 

Log. e(TAG, e. toString()); 

msg("Error occurred while invoking V'observeV" API"); 


) 


} 
// 保 持 观 察 到 的 当前 值 
private static int mObserveCount = 0; 
/ * 当 "post" 请 求 成 功 ,会 执行 下 面 的 事件 处 理 器 
* @param list list of the header options 
* (param ocRepresentation 资源 表示 
* (param sequenceNumber 序列 号 * / 
@override 
public synchronized void onObserveCompleted(List < OcHeaderOption> list, 
OcRepresentation ocRepresentation, 
int sequenceNumber) { 
if (OcResource. OnObserveListener. REGISTER == sequenceNumber) { 
msg("Observe registration action is successful:") ; 
} else if (OcResource.OnObserveListener. DEREGISTER == sequenceNumber) { 
msg("Observe De - registration action is successful"); 
) else if (OcResource.OnObserveListener.NO OPTION == sequenceNumber) { 
msg(" Observe registration or de - registration action is failed"); 
) 
msg( "OBSERVE Result:"); 
msg("\tSequenceNumber:" + sequenceNumber); 
try { 
mLight. setOcRepresentat ion(ocRepresentation) ; 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
msg("Failed to get the attribute values") ; 
} 
msg(mLight. toString()); 
if ((4++mObserveCount) == 11) { 
msg("Cancelling Observe..."); 
try { 
mFoundLightResource. cancelObserve(); 
) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
msg("Error occurred while invoking \"cancelObserve\" API"); 
} 
msg("DONE") ; 
// 准 备 SinpleClient 下 一 次 重启 
resetGlobals(); 
enableStartButton(); 
} 
} 
/xx 
* 当 "observe" 请 求 失败 ,会 执行 下 面 的 事件 处 理 器 
* (param throwable exception * / 
GOverride 
public synchronized void onObserveFailed(Throwable throwable) { 
if (throwable instanceof OcException) ( 
OcException ocEx = (OcException) throwable; 
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sleep(1); 

nFoundLightResource. observe(ObserveType. OBSERVE, new HashMap < String, String>(), this); 
) catch (OcException e) { 

Log. e(TAG, e. toString()); 

msg("Error occurred while invoking V'observeV" API"); 


) 


} 
// 保 持 观 察 到 的 当前 值 
private static int mObserveCount = 0; 
/ * 当 "post" 请 求 成 功 ,会 执行 下 面 的 事件 处 理 器 
* @param list list of the header options 
* (param ocRepresentation 资源 表示 
* (param sequenceNumber 序列 号 * / 
@override 
public synchronized void onObserveCompleted(List < OcHeaderOption> list, 
OcRepresentation ocRepresentation, 
int sequenceNumber) { 
if (OcResource. OnObserveListener. REGISTER == sequenceNumber) { 
msg("Observe registration action is successful:") ; 
} else if (OcResource.OnObserveListener. DEREGISTER == sequenceNumber) { 
msg("Observe De - registration action is successful"); 
) else if (OcResource.OnObserveListener.NO OPTION == sequenceNumber) { 
msg(" Observe registration or de - registration action is failed"); 
) 
msg( "OBSERVE Result:"); 
msg("\tSequenceNumber:" + sequenceNumber); 
try { 
mLight. setOcRepresentat ion(ocRepresentation) ; 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
msg("Failed to get the attribute values") ; 
} 
msg(mLight. toString()); 
if ((4++mObserveCount) == 11) { 
msg("Cancelling Observe..."); 
try { 
mFoundLightResource. cancelObserve(); 
) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
msg("Error occurred while invoking \"cancelObserve\" API"); 
} 
msg("DONE") ; 
// 准 备 SinpleClient 下 一 次 重启 
resetGlobals(); 
enableStartButton(); 
} 
} 
/xx 
* 当 "observe" 请 求 失败 ,会 执行 下 面 的 事件 处 理 器 
* (param throwable exception * / 
GOverride 
public synchronized void onObserveFailed(Throwable throwable) { 
if (throwable instanceof OcException) ( 
OcException ocEx = (OcException) throwable; 
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Log. e(TAG, ocEx. toString()); 
ErrorCode errCode - ocEx.getErrorCode(); 
//do something based on errorCode 
msg("Error code: " + errCode); 

) 


msg("Observation of the found light resource has failed"); 


) 
//01C 部 分 的 代码 结束 ,设置 代码 开始 
private final static String TAG = SimpleClient.class.getSimpleName(); 
private TextView mConsoleTextView; 
private ScrollView nScrollView; 
protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState) ; 
setContentView(R. layout. activity_simple_client); 
mConsoleTextView = (TextView) findViewById(R. id. consoleTextView) ; 
nConsoleTextView. setMovenentMethod(new ScrollingMovementMethod()); 
mScrollView = (ScrollView) findViewById(R. id. scrollView); 
mScrollView.fullScroll(View.FOCUS DOWN); 
final Button button = (Button) findViewById(R. id. button); 
1 * 修改 开始 * / 
Button buttonl = (Button) findViewById(R. id. button1); 
buttonl.setOnClickListener(new View. OnClickListener()( 
public void onClick(View v)( 
) 
n»; 


// 修 改 结束 
if (null == savedInstanceState) { 
button. setOnClickListener(new View. OnClickListener() { 
@override 
public void onClick(View v) { 
button. setText ("Re — start"); 
button. setEnabled( false) ; 
new Thread(new Runnable() { 
public void run() { 
startSimpleClient() ; 
} 
}). start(); 
} 
n 
} else { 
String consoleOutput = savedInstanceState. getString("consoleOutputString"); 
mConsoleTextView. setText(consoleOutput); 


) 
@override 
protected void onSaveInstanceState(Bundle outState) { 
super. onSaveInstanceState(outState); 
outState. putString("consoleOutputString", mConsoleTextView. getText(). toString()); 
) 
@override 
protected void onRestoreInstanceState( Bundle savedInstanceState) { 
super. onRestoreInstanceState(savedInstanceState) ; 
String consoleOutput = savedInstanceState. getString("consoleOutputString"); 
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nConsoleTextView. setText (consoleOutput) ; 
) 
private void enableStartButton() ( 
runOnUiThread(new Runnable() ( 
public void run() { 
Button button - (Button) findViewById(R. id. button); 
button. setEnabled(true); 
) 
n; 
) 
private void sleep(int seconds) ( 
try { 
Thread. sleep(seconds * 1000); 
} catch (InterruptedException e) { 
e. printStackTrace( ) ; 
Log. e(TAG, e. toString()) ; 
) 
) 
private void nsg(final String text) ( 
runOnUiThread(new Runnable() ( 
public void run() ( 
nConsoleTextView. append("\n") ; 
nConsoleTextView. append(text) ; 
nScrollView. fullScroll(View.FOCUS DOWN); 
} 
n; 
Log. i(TAG, text); 
} 
private void printLine() { 
BEG SS SS Se "W 


private synchronized void resetGlobals() { 
mFoundLightResource = null; 
mFoundResources. clear() ; 
mLight = new Light(); 
mObserveCount = 0; 
} 
@override 
public void onNewIntent(Intent intent) { 
super. onNewIntent( intent) ; 
Log. d(TAG, "onNewIntent with changes sending broadcast IN"); 
Intent i = new Intent(); 
i. setAction( intent. getAction()); 
i.putExtra(NfcAdapter.EXTRA NDEF MESSAGES, 
intent.getParcelableArrayExtra(NfcAdapter. EXTRA NDEF MESSAGES)); 
sendBroadcast(i); 
Log.d(TAG, "Initialize Context again resetting"); 


) 


2. simpleserver 
5j simpleclient 相似 , simpleserver 工程 中 同样 包含 两 个 Java 文件 .分别 为 Light. java 和 


SimpleServer. java。 
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nConsoleTextView. setText (consoleOutput) ; 
) 
private void enableStartButton() ( 
runOnUiThread(new Runnable() ( 
public void run() { 
Button button - (Button) findViewById(R. id. button); 
button. setEnabled(true); 
) 
n; 
) 
private void sleep(int seconds) ( 
try { 
Thread. sleep(seconds * 1000); 
} catch (InterruptedException e) { 
e. printStackTrace( ) ; 
Log. e(TAG, e. toString()) ; 
) 
) 
private void nsg(final String text) ( 
runOnUiThread(new Runnable() ( 
public void run() ( 
nConsoleTextView. append("\n") ; 
nConsoleTextView. append(text) ; 
nScrollView. fullScroll(View.FOCUS DOWN); 
} 
n; 
Log. i(TAG, text); 
} 
private void printLine() { 
BEG SS SS Se "W 


private synchronized void resetGlobals() { 
mFoundLightResource = null; 
mFoundResources. clear() ; 
mLight = new Light(); 
mObserveCount = 0; 
} 
@override 
public void onNewIntent(Intent intent) { 
super. onNewIntent( intent) ; 
Log. d(TAG, "onNewIntent with changes sending broadcast IN"); 
Intent i = new Intent(); 
i. setAction( intent. getAction()); 
i.putExtra(NfcAdapter.EXTRA NDEF MESSAGES, 
intent.getParcelableArrayExtra(NfcAdapter. EXTRA NDEF MESSAGES)); 
sendBroadcast(i); 
Log.d(TAG, "Initialize Context again resetting"); 


) 


2. simpleserver 
5j simpleclient 相似 , simpleserver 工程 中 同样 包含 两 个 Java 文件 .分别 为 Light. java 和 


SimpleServer. java。 
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1) Light. java 文件 中 的 代码 


package org. iotivity. base. examples; 

import android. content. Context; 

import android. content. Intent; 

import android. util. Log; 

import org. iotivity. base. EntityHandlerResult; 

import org. iotivity. base. ErrorCode; 

import org. iotivity. base. ObservationInfo; 

import org. iotivity. base. OcException; 

import org. iotivity. base. OcPlatform; 

import org. iotivity. base. OcRepresentation; 

import org. iotivity. base. OcResource; 

import org. iotivity. base. OcResourceHandle; 

import org. iotivity. base. OcResourceRequest; 

import org. iotivity. base. OcResourceResponse; 

import org. iotivity. base. RequestHandlerFlag; 

import org. iotivity. base. RequestType; 

import org. iotivity. base. ResourceProperty; 

import java. util. EnumSet; 

import java. util. LinkedList; 

import java. util. List; 

import java. util. Map; 

/ * Light, RRA — Light 资源 * / 

public class Light implements OcPlatform. EntityHandler { 
private static final String NAME_KEY = "name"; 
private static final String STATE_KEY = "state"; 
private static final String POWER KEY = "power"; 


private String mResourceUri; // 资 源 URI 
private String mResourceTypeName; // 资 源 类 型 名 
private String mResourceInterface; // 资 源 接口 
private OcResourceHandle mResourceHandle; 

private String mName; //light 名 称 
private boolean mState; //Aight 状态 
private int mPower; //light 功率 


public Light(String resourceUri, String name, boolean state, int power) { 


mResourceUri = resourceUri; 

mResourceTypeName = "core.light"; 

mResourceInterface - OcPlatform.DEFAULT INTERFACE; 
mResourceHandle - null; // 资 源 注册 时 设置 该 值 
mName = name; 

mState = state; 

mPower = power; 


} 
public synchronized void registerResource() throws OcException { 
if (null == mResourceHandle) ( 
mResourceHandle = OcPlatform. registerResource( 

mResourceUri, 
mResourceTypeName, 
mResourceInterface, 
this, 


EnumSet. of (ResourceProperty. DISCOVERABLE, ResourceProperty. OBSERVABLE) 


2 
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/* 注意: 这 只 是 事件 处 理 器 的 一 个 简单 实现 
* @param request 
* @return* / 
@Override 
public synchronized EntityHandlerResult handleEntity(final OcResourceRequest request) { 
EntityHandlerResult ehResult = EntityHandlerResult. ERROR; 
if (null == request) { 
msg("Server request is invalid"); 
return ehResult; 
} 
//Get the request flags 
EnumSet < RequestHandlerFlag > requestFlags = request. getRequestHandlerFlagSet( ) ; 
if (requestFlags. contains(RequestHandlerFlag. INIT) ) { 
msg("\t\tRequest Flag: Init"); 
ehResult = EntityHandlerResult. OK; 
} 
if (requestFlags. contains(RequestHandlerFlag. REQUEST) ) { 
msg("\t\tRequest Flag: Request"); 
ehResult - handleRequest(request); 
) 
if (requestFlags. contains(RequestHandlerFlag. OBSERVER) ) ( 
msg("\t\tRequest Flag: Observer"); 
ehResult = handleObserver(request); 
) 
return ehResult; 
) 
private EntityHandlerResult handleRequest(OcResourceRequest request) { 
EntityHandlerResult ehResult - EntityHandlerResult. ERROR; 
// 检 查 查 询 参数 (如 果 有 的 话 ) 
Map < String, String> queries = request.getQueryParameters(); 
if (!queries. isEnpty()) ( 
msg("Query processing is up to entityHandler"); 
) eise ( 
nsg("No query parameters in this request"); 
) 
for (Map.Entry«String, String> entry : queries. entrySet()) { 
msg("Query key: " + entry.getKey() + " value: " + entry.getValue()); 
} 
// 获 取 请 求 类 型 
RequestType requestType = request. getRequestType() ; 
switch (requestType) { 
case GET: 
msg("\t\t\tRequest Type is GET"); 
ehResult = handleGetRequest (request) ; 
break; 
case PUT: 
msg("\t\t\tRequest Type is PUT"); 
ehResult = handlePutRequest (request) ; 
break; 
case POST: 
msg("\t\t\tRequest Type is POST"); 
ehResult = handlePostRequest( request) ; 
break; 
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case DELETE: 
msg("\t\t\tRequest Type is DELETE") ; 
ehResult = handleDeleteRequest( ) ; 
break; 
} 
return ehResult; 
} 
private EntityHandlerResult handleGetRequest (final OcResourceRequest request) { 
EntityHandlerResult ehResult; 
OcResourceResponse response = new OcResourceResponse(); 
response. setRequestHandle(request. getRequestHandle()); 
response. setResourceHandle( request. getResourceHandle()) ; 
if (mIsSlowResponse) ( // 慢 响应 的 情况 
new Thread(new Runnable() ( 
public void run() ( 
handleSlowResponse(request); 
} 
}). start(); 
ehResult = EntityHandlerResult. SLOW; 
} else { // 正 常 响 应 的 情况 
response. setErrorCode(SUCCESS) ; 
response. setResponseResult (Ent ityHandlerResult. OK) ; 
response. setResourceRepresentat ion(getOcRepresentation()); 
ehResult = sendResponse(response); 
) 
return ehResult; 
) 
private EntityHandlerResult handlePutRequest(OcResourceRequest request) ( 
OcResourceResponse response = new OcResourceResponse(); 
response. setRequestHandle(request. getRequestHandle()) ; 
response. setResourceHandle( request. getResourceHandle()) ; 
setOcRepresentation(request. getResourceRepresentation()); 
response. setResourceRepresentation(getOcRepresentation()); 
response. setResponseResult (Ent ityHandlerResult. OK); 
response. setErrorCode( SUCCESS) ; 
return sendResponse( response) ; 
} 
private static int sUriCounter = 1; 
private EntityHandlerResult handlePostRequest (OcResourceRequest request) { 
OcResourceResponse response = new OcResourceResponse( ) ; 
response. setRequestHandle( request. getRequestHandle()); 
response. setResourceHandle( request. getResourceHandle()) ; 
String newUri = "/a/light" + (++sUriCounter) ; 
if(null != mContext && mContext instanceof SimpleServer) { 
((SimpleServer) mContext). createNewLightResource(newUri, "John's light " + sUriCounter) ; 
} 
OcRepresentation rep post = getOcRepresentation(); 
try { 
rep post. setValue(OcResource. CREATED URI KEY, newUri); 
) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
) 
response. setResourceRepresentation(rep post); 
response. setErrorCode(SUCCESS) ; 


第 12 章 “OCF 开 发 方法 及 案例 || 337 


response. setNewResourceUri(newUri); 
response. setResponseResult(EntityHandlerResult. RESOURCE, CREATED) ; 
return sendResponse(response) ; 
} 
private EntityHandlerResult handleDeleteRequest() { 
try{ 
this. unregisterResource( ) ; 
return EntityHandlerResult. RESOURCE DELETED; 
) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
msg("Failed to unregister a light resource"); 
return EntityHandlerResult. ERROR; 
) 
) 
private void handleSlowResponse(OcResourceRequest request) ( 
sleep(10); 
msg("Sending slow response..."); 
OcResourceResponse response = new OcResourceResponse() ; 
response. setRequestHandle( request. getRequestHandle()) ; 
response. setResourceHandle( request. getResourceHandle()) ; 
response. setErrorCode( SUCCESS) ; 
response. setResponseResult(EntityHandlerResult. OK) ; 
response. setResourceRepresentat ion(getOcRepresentation()); 
sendResponse( response) ; 





) 

private List < Byte» mObservationIds; 
private EntityHandlerResult handleObserver(final OcResourceRequest request) ( 

ObservationInfo observationInfo = request.getObservationInfo(); 

switch (observationInfo.getObserveAction()) { 

case REGISTER: 
if (null == mObservationIds) { 
mObservationIds = new LinkedList <>(); 





] 
mObservationIds. add(observationInfo. getOcObservationId()); 
break; 
case UNREGISTER: 
mObservationlds. remove( (Byte) observat ionInfo. getOcObservationId()); 
break; 
) 
/ /notifyObservers 方法 中 的 一 个 线程 中 进行 Observation 
// 如 果 还 没有 创建 线程 , 则 在 此 处 先 创建 
if (null == mObserverNotifier) { 
mObserverNotifier = new Thread(new Runnable() ( 
public void run() ( 
notifyObservers(request); 
) 
n; 
mObserverNotifier.start(); 
) 
return EntityHandlerResult.OK; 
H 
private void notifyObservers(OcResourceRequest request) ( 
while (true) ( 
//& 2s 功率 加 10 
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mPower += 10; 
sleep(2); 
msg("Notifying observers..."); 
nsg(this. toString()); 
try { 
if (nIsListOfObservers) ( 
OcResourceResponse response = new OcResourceResponse(); 
response. setErrorCode(SUCCESS) ; 
response. setResourceRepresentat ion(getOcRepresentation()) ; 
OcPlatform. notifyListOfObservers( 
mResourceHandle, 
mObservationIds, 
response) ; 
} else { 
OcPlatform. notifyAll0bservers(mResourceHandle) ; 
} 
} catch (OcException e) { 
ErrorCode errorCode = e. getErrorCode() ; 
if (ErrorCode. NO_OBSERVERS == errorCode) { 
msg("No more observers, stopping notifications"); 
l 


return; 


} 
) 
private EntityHandlerResult sendResponse(OcResourceResponse response) ( 

try { 
OcPlatform. sendResponse( response) ; 
return EntityHandlerResult. OK; 

) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
msg("Failed to send response"); 
return EntityHandlerResult. ERROR; 


) 
public synchronized void unregisterResource() throws OcException ( 


if (null != mResourceHandle) { 
OcPlatform. unregisterResource(mResourceHandle) ; 


) 
public void setOcRepresentation(OcRepresentation rep) { 


try ( 
if (rep.hasAttribute(NAME KEY)) mName = rep.getValue(NAME KEY); 
if (rep.hasAttribute(STATE KEY)) mState = rep.getValue(STATE KEY); 
if (rep. hasAttribute(POWER_KEY)) mPower = rep.getValue(POWER KEY); 
) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
nsg("Failed to get representation values"); 


) 
public OcRepresentation getOcRepresentation() { 


OcRepresentation rep - new OcRepresentation(); 


try { 
rep.setValue(NAME KEY, mName) ; 
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rep.setValue(STATE KEY, mState); 
rep.setValue(POWER KEY, mPower); 
} catch (OcException e) { 
Log.e(TAG, e.toString()); 
msg("Failed to set representation values"); 
} 
return rep; 
} 
//o1c 部 分 代码 结束 ,设置 开始 
public void setSlowResponse(boolean isSlowResponse) { 
mIsSlowResponse = isSlowResponse; 
} 
public void useListOfObservers(boolean isListOfObservers) ( 
mIsListOfObservers = isListOfObservers; 
} 
public void setContext(Context context) { 
mContext = context; 
} 
@override 
public String toString() { 
return "At" + "URI" + ":" + mResourceUri + 
"\n\t" + NAME KEY + ":" + mName + 
"\n\t" STATE KEY + ": " + mState + 
"\n\t" + POWER KEY + ": " + mPower; 
} 
private void sleep(int seconds) { 
try { 
Thread.sleep(seconds * 1000); 
) catch (InterruptedException e) ( 
e. printStackTrace(); 
Log. e(TAG, e.toString()); 


) 
private void msg(String text) ( 
if (null != mContext) { 
Intent intent = new Intent("org. iotivity. base. examples. simpleserver") ; 
intent. putExtra("message", text) ; 
mContext. sendBroadcast( intent); 


) 
private final static String TAG - Light.class.getSimpleName(); 


private final static int SUCCESS - 200; 
private boolean nIsSlowResponse - false; 
private boolean nIsListOfObservers - false; 
private Thread nObserverNotifier; 
private Context nContext; 

} 


2) SimpleServer. java 文件 中 的 代码 


package org. iotivity. base. examples; 
import android. app. Activity; 

import android. content. BroadcastReceiver; 
import android. content. Context; 
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import android.content. Intent; 
import android. content. IntentFilter; 
import android. nfc. NfcAdapter; 
import android. os. Bundle; 
import android. text. method. ScrollingMovementMethod; 
import android. util. Log; 
import android. view. View; 
import android. widget. CompoundButton; 
import android. widget. ScrollView; 
import android. widget. TextView; 
import android. widget. ToggleButton; 
import org. iotivity. base. ModeType; 
import org. iotivity. base. OcException; 
import org. iotivity. base. OcPlatforn; 
import org. iotivity.base. PlatformConf ig; 
import org. iotivity. base. QualityOfService; 
import org. iotivity. base. ServiceType; 
import java. util. LinkedList; 
import java. util. List; 
/ * SinpleServer, SinpleServer 是 一 个 简单 的 OIC 服务 器 端 应 用 .该 程序 创建 了 一 个 灯 的 资源 ,并 对 客户 端的 呼叫 
进行 处 理 * / 
public class SimpleServer extends Activity ( 
List < Light > lights = new LinkedList <>(); 
/* 该 方法 用 于 配置 和 初始 化 平台 ,然后 创建 一 个 Light 资源 * / 
private void startSimpleServer() { 
Context context = this; 
PlatformConfig platformConfig = new PlatformConfig( 
this, 
context, 
ServiceType. IN_PROC, 
ModeType. SERVER, 
"0.0.0.0", // 通 过 设置 为 "0.0.0.0" 绑 定 到 所 有 可 用 的 接口 
0, // 使 用 随机 可 用 的 端口 
QualityOfService. LOW 
E 
msg("Configuring platform."); 
OcPlatform. Conf igure(platformConfig); 
createNewLightResource(" /a/light", "John's light"); 
msg(" Waiting for the requests..."); 
printLine(); 
enableStartStopButton(); 
} 
public void createNewLightResource(String resourceUri, String resourceName) { 
msg("Creating a light"); 
Light light = new Light( 


resourceUri, //URI 
resourceName, // 名 称 
false, // 状 态 
0 // 功 率 


E 

msg( light. toString()); 

light. setContext(this) ; 
msg("Registering light as a resource"); 
try { 
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light.registerResource(); 
) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
nsg("Failed to register a light resource"); 
} 
lights. add(light); 
) 
private void stopSimpleServer() ( 
for (Light light : lights) ( 
try ( 
light. unregisterResource(); 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
nsg("Failed to unregister a light resource"); 


) 
lights.clear(); 
msg("All created resources have been unregistered"); 
printLine(); 
enableStartStopButton(); 
) 
//o1c 部 分 代码 结束 ,设置 开始 
private final static String TAG = SimpleServer. class. getSimpleName( ) ; 
private MessageReceiver mMessageReceiver = new MessageReceiver() ; 
private TextView mConsoleTextView; 
private ScrollView mScrollView; 
@override 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R.layout.activity simple server); 
registerReceiver(mMessageReceiver, 
new IntentFilter("org. iotivity. base. examples. sinpleserver")); 
mConsoleTextView = (TextView) findViewById(R. id. consoleTextView); 
mConsoleTextView. setMovementMethod(new ScrollingMovementMethod()); 
mScrollView = (ScrollView) findViewById(R. id. scrollView); 
mScrollView.fullScroll(View.FOCUS DOWN); 
final ToggleButton toggleButton = (ToggleButton) findViewById(R. id. toggleButton); 
if (null == savedInstanceState) ( 
toggleButton. setOnCheckedChangeListener(new CompoundButton. OnCheckedChangeListener() ( 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) ( 
toggleButton. setEnabled(false); 
if (isChecked) ( 
new Thread(new Runnable() ( 
public void run() ( 
startSimpleServer(); 
} 
}). start(); 
} else { 
new Thread(new Runnable() { 
public void run() { 
stopSimpleServer(); 
) 
)).start(); 
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} 
n 
} else { 
String consoleOutput = savedInstanceState. getString("consoleOutputString"); 
mConsoleTextView. setText(consoleOutput); 
boolean buttonCheked = savedInstanceState. getBoolean("toggleButtonChecked" ) ; 
toggleButton. setChecked(buttonCheked) ; 
} 
} 
@override 
public void onDestroy() { 
super. onDestroy(); 
onStop(); 
) 
@Override 
protected void onStop() { 
//unregisterReceiver(mMessageReceiver) ; 
super. onStop() ; 
) 
@override 
protected void onSaveInstanceState(Bundle outState) { 
super. onSaveInstanceState(outState); 
outState. putStr ing( "consoleOutputString", mConsoleTextView. getText(). toString()); 
ToggleButton toggleButton = (ToggleButton) findViewById(R. id. toggleButton); 
outState. putBoolean("toggleButtonChecked", toggleButton. isChecked()); 
) 
@override 
protected void onRestoreInstanceState( Bundle savedInstanceState) { 
super. onRestoreInstanceState(savedInstanceState) ; 
String consoleOutput = savedInstanceState. getString("consoleOutputString" ) ; 
mConsoleTextView. setText (consoleOutput) ; 
final ToggleButton toggleButton = (ToggleButton) findViewById(R. id. toggleButton) ; 
boolean buttonCheked = savedInstanceState. getBoolean("toggleButtonChecked" ) ; 
toggleButton. setChecked(buttonCheked) ; 
) 
private void msg(final String text) ( 
runOnUiThread(new Runnable() { 
public void run() ( 
mConsoleTextView. append("\n") ; 
mConsoleTextView. append( text) ; 
nScrollView. fullScrol1 (View. FOCUS_DOWN) ; 
t 
n»; 
Log. i(TAG, text); 
) 
private void printLine() ( 
NRG = "j; 


private void sleep(int seconds) ( 
try { 
Thread. sleep(seconds * 1000); 
} catch (InterruptedException e) { 
e. printStackTrace() ; 
Log. e(TAG, e. toString()); 
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} 
} 
private void enableStartStopButton() { 
runOnUiThread(new Runnable() { 
public void run() { 
ToggleButton toggleButton = (ToggleButton) findViewById(R. id. toggleButton) ; 
toggleButton. setEnabled( true); 


H; 
} 
public class MessageReceiver extends BroadcastReceiver { 
@override 
public void onReceive(Context context, Intent intent) { 
final String message = intent. getStringExtra("message") ; 
msg(message) ; 
) 
} 
@override 
public void onNewIntent(Intent intent) { 
super. onNewIntent( intent) ; 
Log. d(TAG, "onNewIntent with changes sending broadcast IN"); 
Intent i = new Intent(); 
i. setAction( intent. getAction()) ; 
i.putExtra(NfcAdapter.EXTRA NDEF MESSAGES, 
intent.getParcelableArrayExtra(NfcAdapter. EXTRA NDEF MESSAGES)); 
sendBroadcast ( i) ; 
Log.d(TAG, "Initialize Context again resetting"); 


12.5 基于 Arduino 的 开发 方法 


本 节 主 要 包括 配置 Arduino 环境 软件 工具 的 安装 ,程序 编译 和 实例 代码 。 
12.5.1 配置 Arduino 环境 

Iotivity 的 Arduino 代码 在 Linux 的 交叉 环境 下 编译 ,环境 配置 参考 12.3 节 。 
12.5.2 软件 工具 的 安装 

在 iotivity 根 目录 下 运行 : 

$ sudo apt- get install dos2unix 


12.5.3 程序 编译 


CD 编译 指令 。 
f£ Iotivity 根 目录 下 运行 以 下 指令 : 


scons resource/csdk/stack/samples/arduino/SimpleClientServer/ V 
TARGET OS = arduino TARGET ARCH = < target arch value BOARD =< target board value» V 
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TARGET TRANSPORT = < target transport value» SHIELD = < target. shield value» 
(2) 编译 选项 。 


Arduino RTMega 2560: 
«target board value? = mega 

«target arch value» - avr 

«target transport value» - BLE | IP 
«target shield value» = ETH 

Arduino Due: 

«target board value» = arduino due x 
«target arch value» = arm 

«target transport value» = BLE | IP 
«target shield value» = ETH 


(3) 烧 写 指令 。 
在 lotivity 根 目 录 下 运行 以 下 指令 : 


scons resource/csdk/stack/samples/arduino/SimpleClientServer/ TARGET OS = arduino VTARGET ARCH = < target_ 
arch value» BOARD = < target board value» VTARGET TRANSPORT = < target transport value SHIELD = < target. 
shield value» UPLOAD - true 


烧 写 操作 自动 将 示例 代码 编译 生成 的 可 执行 文件 烧 写 到 Arduino 设备 上 ,代码 路 径 : 


( IOTIVITY | /resource/csdk/stack/samples/arduino/SimpleClientServer/ocserver/ocserver. cpp。 


12.5.4 实例 代码 
该 实例 描述 作为 服务 器 端的 Arduino ,展示 基本 的 资源 创建 和 资源 操作 。 


# include "Arduino. h" 

# include "logger. h" 

# include "ocstack. h" 

# include "ocpayload. h" 

# include < string. h> 

# ifdef ARDUINOWIFI 

//Arduino WiFi 扩展 板 

# include < SPI. h> 

# include < WiFi. h> 

# include < WiFiUdp. h> 

#elif defined ARDUINOETH 
//Axduino 以 太 网 扩展 板 

# include < EthernetServer.h> 
# include < Ethernet. h> 

# include < Dns. h> 

# include < EthernetClient. h> 
# include < util. h> 

# include < EthernetUdp. h> 

# include < Dhcp. h> 

# endif 

const char * getResult(OCStackResult result); 
# def ine TAG "ArduinoServer" 
int gLightUnderObservation - 0; 
void createLightResource(); 


/* 用 结构 体 表 示 Light 资源 * / 
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TARGET TRANSPORT = < target transport value» SHIELD = < target. shield value» 
(2) 编译 选项 。 


Arduino RTMega 2560: 
«target board value? = mega 

«target arch value» - avr 

«target transport value» - BLE | IP 
«target shield value» = ETH 

Arduino Due: 

«target board value» = arduino due x 
«target arch value» = arm 

«target transport value» = BLE | IP 
«target shield value» = ETH 


(3) 烧 写 指令 。 
在 lotivity 根 目 录 下 运行 以 下 指令 : 


scons resource/csdk/stack/samples/arduino/SimpleClientServer/ TARGET OS = arduino VTARGET ARCH = < target_ 
arch value» BOARD = < target board value» VTARGET TRANSPORT = < target transport value SHIELD = < target. 
shield value» UPLOAD - true 


烧 写 操作 自动 将 示例 代码 编译 生成 的 可 执行 文件 烧 写 到 Arduino 设备 上 ,代码 路 径 : 


( IOTIVITY | /resource/csdk/stack/samples/arduino/SimpleClientServer/ocserver/ocserver. cpp。 


12.5.4 实例 代码 
该 实例 描述 作为 服务 器 端的 Arduino ,展示 基本 的 资源 创建 和 资源 操作 。 


# include "Arduino. h" 

# include "logger. h" 

# include "ocstack. h" 

# include "ocpayload. h" 

# include < string. h> 

# ifdef ARDUINOWIFI 

//Arduino WiFi 扩展 板 

# include < SPI. h> 

# include < WiFi. h> 

# include < WiFiUdp. h> 

#elif defined ARDUINOETH 
//Axduino 以 太 网 扩展 板 

# include < EthernetServer.h> 
# include < Ethernet. h> 

# include < Dns. h> 

# include < EthernetClient. h> 
# include < util. h> 

# include < EthernetUdp. h> 

# include < Dhcp. h> 

# endif 

const char * getResult(OCStackResult result); 
# def ine TAG "ArduinoServer" 
int gLightUnderObservation - 0; 
void createLightResource(); 


/* 用 结构 体 表 示 Light 资源 * / 


第 12 章 “OCF 开 发 方法 及 案例 || 345 


typedef struct LIGHTRESOURCE( 
OCResourceHandle handle; 
bool state; 
int power; 
) LightResource; 
static LightResource Light; 
# ifdef ARDUINOWIFI 
/ /Arduino WiFi 扩展 板 
// 注 意 : Arduino WiFi 扩 展板 当前 不 支持 多 播 , 因此 ,服务 器 端 不 能 监听 224.0. 1.187 多 播 地 址 
static const char ARDUINO WIFI SHIELD UDP FW VER[] = "1.1.0"; 
//WiFi 扩展 板 烧 录 Intel 固件 补丁 
static const char INTEL_WIFI_SHIELD_FW_VER[] = "1.2.0"; 
//WiFi 网 络 信息 
char ssid[] = "mDNSAP"; 
char pass[] = "letmein9"; 
int Connect ToNetwork( ) 
{ 





char * fwVersion; 
int status = WL_IDLE_STATUS; 
// 检 查 WiFi 扩展 板 的 存在 
if (WiFi. status() == WL NO SHIELD) 
{ 
OIC LOG(ERROR, TAG, ("WiFi shield not present") ); 
return - 1; 
} 
// 验 证 WiFi 扩展 板 是 否 正在 运行 所 有 UDP 修复 程序 的 固件 
fwVersion = WiFi.firmwareVersion(); 
OIC LOG V(INFO, TAG, "WiFi Shield Firmware version $ s", fwVersion); 
if ( strnemp(fwVersion, ARDUINO WIFI SHIELD UDP FW VER, sizeof(ARDUINO WIFI SHIELD UDP FW VER)) != 0 ) 
{ 





OIC LOG(DEBUG, TAG, (" 
return - 1; 





!! Upgrade WiFi Shield Firmware version ! 1"); 
) 
// 尝 试 连接 WiFi 网 络 
while (status != WL CONNECTED) 
{ 
OIC_LOG_V(INFO, TAG, "Attempting to connect to SSID: %s", ssid); 
status = WiFi. begin(ssid, pass); 
// 等 待 10s 再 连接 
delay(10000); 
) 
OIC LOG(DEBUG, TAG, ("Connected to wifi")); 
IPAddress ip = WiFi.localIP(); 
OIC LOG V(INFO, TAG, "IP Address: %d. %d. %d. *d", ip[0], ip[1], ip[2], ip[3]); 
return 0; 
) 
# elif defined ARDUINOETH 
/ /Arduino 以 太 网 扩展 板 
int ConnectToNetwork() 
{ 
// 注 意 : 使 用 自己 的 防火 墙 MAC 地 址 更 新 此 处 的 MAC 地 址 
uint8 t ETHERNET MAC[] = (0x90, OxA2, OxDA, OxOE, 0xC4, 0x05}; 
uint8 t error - Ethernet. begin(ETHERNET MAC); 
if (error -- 0) 
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{ 
OIC_LOG V(ERROR, TAG, "error is: %d", error); 
return -1; 
} 
IPAddress ip = Ethernet. localIP(); 
OIC LOG V(INFO, TAG, "IP Address: &d. %d. d. &d", ip[0], ip[1], ip[2], ip[3]); 
return 0; 
} 
# endif 
// 在 具有 哈佛 内 存 架 构 的 Arduino Atmel 开发 板 上 ,堆栈 从 顶部 向 下 生长 
// 堆 向 上 生长 .此 方法 将 打印 这 两 者 之 间 的 距离 (以 字 节 为 单位 ) 
/* 详 见 http://www. atmel. com/webdoc/AVRLibcReferenceManual/malloc_1malloc_intro. html * / 
void PrintArduinoMemoryStats() 
t 
# ifdef ARDUINO AVR MEGA2560 
// 此 变量 在 ave - Libc/stdlib/malloc.c 中 声明 
// 它 使 得 最 大 的 地 址 没有 分 配给 堆 
externchar *  brkval; 
//tmp 地 址 提供 当前 协议 栈 的 边界 
int tmp; 
OIC LOG V(INFO, TAG, "Stack: %u Heap: %u", (unsigned int)&tmp, (unsigned int) brkval); 
OIC LOG V(INFO, TAG, "Unallocated Memory between heap and stack: %u", 
((unsigned int)&tmp — (unsigned int) brkval)); 
# endif 
} 
// 已 注册 资源 的 实体 处 理 句 栖 
// 当 接收 到 对 资源 的 请 求 时 被 ocStack 调用 
OCEntityHandlerResult OCEntityHandlerCb ( OCEntityHandlerFlag flag, OCEntityHandlerRequest * 
entityHandlerRequest,void * callbackParam) 
{ 
OCEntityHandlerResult ehRet = OC EH OK; 
OCEntityHandlerResponse response - (0]; 
OCRepPayload * payload = OCRepPayloadCreate(); 
if(!payload) 
{ 
OIC LOG(ERROR, TAG, ("Failed to allocate Payload")); 
return OC EH ERROR; 
) 
if(entityHandlerRequest && (flag & OC REQUEST FLAG)) 
{ 
OIC LOG (INFO, TAG, ("Flag includes OC REQUEST FLAG")); 
if(OC REST GET == entityHandlerRequest - > method) 
€ 
OCRepPayloadSetUri(payload, "/a/light"); 
OCRepPayloadSetPropBool(payload, "state", true); 
OCRepPayloadSetPropInt(payload, "power", 10); 
} 
else if(OC_REST_PUT == entityHandlerRequest - > method) 
{ 
// 执 行 POT 操作 
OCRepPayloadSetUri(payload, "/a/light"); 
OCRepPayloadSetPropBool(payload, "state", false); 
OCRepPayloadSetPropInt(payload, "power", 0); 
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if (ehRet == OC EH OK) 
{ 
// 生 成 响应 . 注意 这 需要 一 些 与 请 求 消息 有 关 的 信息 
response.requestHandle = entityHandlerRequest 一 > requestHandle; 
response.resourceHandle = entityHandlerRequest 一 > resource; 
response.ehResult = ehRet; 
response. payload = (OCPayload * ) payload; 
response. numSendVendorSpecificHeaderOptions = 0; 
memset (response. sendVendorSpecif icHeaderOptions, 0, 
sizeof response. sendVendorSpecif icHeaderOpt ions) ; 
memset (response. resourceUri, 0, sizeof response. resourceUri) ; 
// 表 明 响 应 不 在 缓存 中 
response. persistentBufferFlag = 0; 
// 发 送 响 应 
if (OCDoResponse(&response) != OC STACK OK) 
{ 
OIC LOG(ERROR, TAG, "Error sending response"); 
ehRet - OC EH ERROR; 


) 
if (entityHandlerRequest && (flag & OC OBSERVE FLAG)) 
{ 
if (OC OBSERVE REGISTER == entityHandlerRequest — > obsInfo. action) 
{ 
OIC LOG (INFO, TAG, ("Received OC OBSERVE REGISTER from client")); 
gLightUnderObservation = 1; 
) 
else if (OC OBSERVE DEREGISTER == entityHandlerRequest - > obsInfo. action) 
f 
OIC LOG (INFO, TAG, ("Received OC OBSERVE DEREGISTER from client") ); 
gLightUnderObservation = 0; 
} 
} 
OCRepPayloadDestroy( payload) ; 
return ehRet; 
} 
// 此 方法 用 作 展 示 OC 协议 的 Observe 功能 
static uint8_t modCounter = 0; 
void * ChangeLightRepresentation (void * param) 
{ 
(void) param; 
OCStackResult result = OC_STACK_ERROR; 
modCounter += 1; 
// 匹 配 Linux 示 例 服务 器 端 应 用 程序 用 于 相同 功能 的 时 间 
if(modCounter & 10 == 0) 
{ 
Light.power += 5; 
if (gLightUnderObservation) 
t 
OIC LOG V(INFO, TAG, " > Notifying stack of new power level %d\n", Light.power); 
result - OCNotifyAllObservers (Light.handle, OC NA Q0S); 
if (OC STACK NO OBSERVERS -- result) 
{ 








348 «|| OCF 技 术 原理 及 物 联网 程序 开发 指南 


gLightUnderObservation = 0; 
) 
) 
) 
return NULL; 
) 
//setup 函数 在 启动 程序 时 被 调用 
void setup() 
{ 
// 在 此 处 添加 你 的 初始 化 代码 
// 注 意 : 在 此 将 初始 化 Arduino 的 串口 波 特 率 为 115200 
OIC LOG INIT(); 
OIC LOG(DEBUG, TAG, ("OCServer is starting...")); 
// 连 接 以 太 网 或 WiFi 网 络 
# if defined(ARDUINOWIFI) || defined(ARDUINOETH) 
if (ConnectToNetwork() != 0) 
{ 
OIC LOG(ERROR, TAG, ("Unable to connect to network") ) ; 
return; 
} 
# endif 
// 在 服务 器 端 模式 下 初始 化 OC 协议 栈 
if (OCInit(NULL, 0, OC_SERVER) !- OC STACK OK) 
{ 
OIC LOG(ERROR, TAG, ("OCStack init error")); 
return; 
} 
// 声 明 并 创建 示例 资源 Light 
createLightResource(); 
} 
//Yoop 函数 被 无 休止 地 调用 
void loop() 
// 在 这 里 保持 人 为 的 延迟 ,以 避免 Arduino 微 控 制 器 的 连续 运转 
// 根 据 具体 应 用 需求 进行 修改 
delay(2000); 
// 此 调用 显示 Arduino 上 释放 的 可 用 SRAM 的 数量 
PrintArduinoMemoryStats(); 
// 给 OC 协议 栈 CPU 周期 来 执行 发 送 /接收 ,以 及 其 他 OC 协议 栈 的 东西 
if (OCProcess() != OC STACK OK) 
{ 
OIC LOG(ERROR, TAG, ("OCStack process error")); 
return; 
) 
ChangeLightRepresentation( NULL); 
) 
void createLightResource() 
{ 
Light. state = false; 
OCStackResult res = OCCreateResource(&Light. handle, 
"core. light", 
OC RSRVD INTERFACE DEFAULT, 
"/a/light", 
OCEntityHandlerCb, 
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NULL, 
OC DISCOVERABLE|OC OBSERVABLE); 
OIC LOG V(INFO, TAG, "Created Light resource with result: %s", getResult(res)); 
) 
const char * getResult(OCStackResult result) ( 

switch (result) ( 
case OC STACK OK: 

return "OC STACK OK"; 
case OC STACK INVALID URI: 

return "OC STACK INVALID URI"; 
case OC STACK INVALID QUERY: 

return "OC STACK INVALID QUERY"; 
case OC STACK INVALID IP: 

return "OC STACK INVALID IP"; 
case OC STACK INVALID PORT: 

return "OC STACK INVALID PORT"; 
case OC STACK INVALID CALLBACK: 

return "OC STACK INVALID CALLBACK"; 
case OC STACK INVALID METHOD: 

return "OC STACK INVALID METHOD"; 
case OC STACK NO MEMORY: 

return "OC STACK NO MEMORY"; 
case 0C STACK COMM ERROR: 

return "OC STACK COMM ERROR"; 
case OC STACK INVALID PARAM: 

return "OC STACK INVALID PARAM"; 
case OC STACK NOTIMPL: 

return "OC STACK NOTIMPL"; 
case OC STACK NO RESOURCE: 

return "OC STACK NO RESOURCE"; 
case OC STACK RESOURCE ERROR: 

return "OC STACK RESOURCE ERROR"; 
case OC STACK SLOW RESOURCE: 

return "OC STACK SLOW RESOURCE"; 
case OC STACK NO OBSERVERS: 

return "OC STACK NO OBSERVERS"; 
case OC STACK ERROR: 

return "OC STACK ERROR"; 
default: 

return "UNKNOWN" ; 


12.6 综合 实例 


本 节 综 合 运 用 IoTivity 技术 ,通过 Arduino 实例 和 Android 实例 ,完成 综合 应 用 。 
12.6.1 Arduino 实例 


该 实例 通过 在 Arduino 服务 器 端 创建 资源 ,搭载 温 湿度 传感器 DH T11 光敏 传感器 和 PM2. 5 传 感 
器 等 ,实现 采集 温 湿 度 值 光 强 值 和 PM2. 5 的 值 。 
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# include "Arduino. h" 

# include "logger. h" 

# include "ocstack. h" 

# include "ocpayload. h" 

# include < string. h> 

# include < dht11.h> 

# ifdef ARDUINOWIFI 

//Arduino WiFi 扩 展板 

# include < SPI. h> 

# include <WiFi.h> 

# include < WiFiUdp. h> 

# elif defined ARDUINOETH 
/Varduino 以 太 网 扩展 板 

# include < EthernetServer.h> 
# include < Ethernet. h> 

# include <Dns.h> 

# include < EthernetClient. h> 
# include < util. h> 

# include < EthernetUdp. h> 

# include < Dhcp. h> 


# endif 

dht11 DHT11; 

# define DHT11PIN 2 // 数 字 2 引 脚 

int LED PIN = 30; //LED, 3| I) 30 

int LIGHT PIN - 0; // 模 拟 引 脚 0, 连接 光 敏 电阻 
int LED STATE = 0; //LED 当前 状态 值 

int lightval = 0; // 光 强 值 

int chk; //pHT11 值 

int tempval = 0; // 温 度 值 

int humval = 0; // 湿 度 值 


int pm25val = 0; 

byte Tx[5] = {OxFE, 0xA5, 0x00, 0x00, 0x5] ; 

byte Rx[7] = (0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}; 
const char * getResult(OCStackResult result); 

# define TAG "ArduinoServer" 

// 资 源 接口 

# define ARDUINO RESOURCE INTERFACE "core. haier. resources" 
# define RESOURCE TYPE "room. haier" 

// 资 源 类 型 

# define TEMPERATURE RESOURCE TYPE "room. temperature” 
# define LIGHT RESOURCE TYPE "ambient. light" 

# define LED RESOURCE TYPE "platform. led" 

// 资 源 URI 

# define TEMPERATURE RESOURCE ENDPOINT "/temperature" 
# define LIGHT RESOURCE ENDPOINT "/ambientlight" 

# define LED RESOURCE ENDPOINT "/led" 

# define PM25 RESOURCE ENDPOINT "/pm25" 

// 资 源 属性 

# define TEMPERATURE RESOURCE KEY "temperature" 

# define LIGHT RESOURCE KEY "anbientlight" 

# define LED RESOURCE KEY "switch" 

# define PM25 RESOURCE KEY "pm25" 

# define HUM RESOURCE KEY "hum" 

int gLightUnderObservation - 0; 


void createLightResource(); 

void createTemperatureResource( ) ; 

void createLedResource(); 

void createPm25Resource( ) ; 

/* 用 结构 体 表示 light 资源 * / 

typedef struct LIGHTRESOURCE{ 
OCResourceHandle lighthandle; 
bool state; 
int power; 
int ambientlight; 

) LightResource; 

typedef struct TEMPERATURERESOURCE ( 
OCResourceHandle temperaturehandle; 
int temperature; 

) TemperatureResource; 

typedef struct LEDRESOURCE( 
OCResourceHandle ledhandle; 
int state; 

) LedResource; 

typedef struct PM25RESOURCE( 
OCResourceHandle pm25handle; 

) Pm25Resource; 

static LightResource Light; 

static TemperatureResource Temperature; 

static LedResource Led; 

static Pm25Resource Pm25; 

# ifdef ARDUINOWIFI 
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//Axduino WiFi 扩 展板 ,注意 , Arduino WiFi 扩 展板 当前 不 支持 多 播 , 因此 服务 器 端 不 能 监听 


//224.0.1.187 多 播 地 址 

static const char ARDUINO_WIFI_SHIELD_UDP_FW_VER[] = "1.1.0"; 
/WWiFi 扩 展板 Intel 固件 补丁 

static const char INTEL WIFI SHIELD FW VER(] = "1.2.0"; 
//WiFi 网 络 信息 

char ssid[] = "mDNSAP"; 

char pass[] = "letmein9"; 

int ConnectToNetwork( ) 

{ 


char * fwVersion; 

int status = WL IDLE STATUS; 

// 检 查 扩 展板 的 存在 

if (WiFi.status() == WL NO SHIELD) 

{ 
OIC LOG(ERROR, TAG, ("WiFi shield not present")); 
return -1; 

) 

// 验 证 WiFi 扩展 板 是 否 正在 运行 所 有 UDP 修复 程序 的 固件 


fwVersion = WiFi.firmwareVersion(); 


OIC LOG V(INFO, TAG, "WiFi Shield Firmware version %s", fwVersion); 


if ( strncmp(fwVersion, ARDUINO WIFI SHIELD UDP FW VER, sizeof(ARDUINO WIFI SHIELD UDP FW VER)) !=0 ) 


{ 
OIC LOG(DEBUG, TAG, (" 
return - 1; 





} 
// 举 试 连接 WiFi 网 络 


! Upgrade WiFi Shield Firmware version ! 





7); 
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while (status != WL CONNECTED) 
{ 
OIC LOG V(INFO, TAG, "Attempting to connect to SSID: %s", ssid); 
status = WiFi. begin(ssid, pass) ; 
// 等 待 10s 再 连接 
delay(10000); 
) 
OIC LOG(DEBUG, TAG, ("Connected to wifi")); 
IPAddress ip = WiFi.localIP(); 
OIC LOG V(INFO, TAG, "IP Address: &d. &d. &d. &d", ip[0], ip[1], ip[2], ip[3]); 
return 0; 
) 
* elif defined ARDUINOETH 
//Arduino 以 太 网 扩展 板 
int ConnectToNetwork( ) 
t 
// 注 意 : 使 用 您 的 防火 墙 的 MAC 地 址 更 新 此 处 的 MAC 地 址 
uint8_t ETHERNET MAC[] = (0x90, OxA2, OxDA, OxOE, OxC4, 0x05}; 
uint8 t error = Ethernet. begin(ETHERNET MAC); 
if (error == 0) 
t 
OIC LOG V(ERROR, TAG, "error is: &d", error); 
return - 1; 
) 
IPAddress ip = Ethernet. localIP(); 
OIC LOG V(INFO, TAG, "IP Address: %d. &d. *d. %d", ip[0], ip[1], ip[2], ip[3]); 
return 0; 
) 
# endif 
// 在 具有 哈佛 内 存 架 构 的 Arduino Atmel 开发 板 上 ,堆栈 从 顶部 向 下 生长 
// 堆 向 上 生长 .此 方法 将 打印 这 两 者 之 间 的 距离 (以 字 节 为 单位 ) 
/x* 详 见 
http://www. atmel. com/webdoc/AVRLibcReferenceManual/malloc_lmalloc_intro. html * / 
void PrintArduinoMemoryStats() 
{ 
# ifdef ARDUINO AVR MEGA2560 
// 此 变量 在 avr - Libc/stdlib/malloc. c 中 声明 
// 它 使 得 最 大 的 地 址 没有 分 配给 堆 
externchar *  brkval; 
//tmp 地 址 提供 当前 协议 栈 的 边界 
int tmp; 
OIC LOG V(INFO, TAG, "Stack: %u Heap: %u", (unsigned int)&tmp, (unsigned int) brkval); 
OIC LOG V(INFO, TAG, "Unallocated Memory between heap and stack: *u", 
((unsigned int)&tmp — (unsigned int) brkval)); 
# endif 
} 
// 已 注册 Light 资源 的 实体 处 理 句柄 


// 当 接收 到 对 资源 的 请 求 时 被 OCStack 调用 
OCEntityHandlerResult OCLightEntityHandlerCb ( OCEntityHandlerFlag flag, OCEntityHandlerRequest 


entityHandlerRequest, void * callbackParam) 
{ 


* 


OCEntityHandlerResult ehRet = OC EH OK; 
OCEntityHandlerResponse response = {0}; 
OCRepPayload * payload = OCRepPayloadCreate(); 
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if(!payload) 
{ 
OIC LOG(ERROR, TAG, ("Failed to allocate Payload" )) ; 
return OC EH ERROR; 
} 
if (entityHandlerRequest && (flag & OC_REQUEST_FLAG) ) 
{ 
OIC LOG (INFO, TAG, ("Flag includes OC REQUEST FLAG")); 
if(OC REST GET == entityHandlerRequest - > method) 
{ 
OCRepPayloadSetUri(payload, LIGHT RESOURCE ENDPOINT); 
OCRepPayloadSetPropInt(payload, "ambientlight", lightval); 
OCRepPayloadSetPropInt(payload, PM25 RESOURCE KEY, 20); 
) 
else if(OC REST PUT == entityHandlerRequest - > method) 
í 
OCRepPayloadSetUri(payload, LIGHT RESOURCE ENDPOINT); 
OCRepPayloadSetPropBool(payload, "state", false); 
OCRepPayloadSetPropInt(payload, "power", 10); 
) 
if (ehRet -- OC EH OK) 
t 
// 生 成 响应 . 注意 这 需要 一 些 与 请 求 消息 有 关 的 信息 
response.requestHandle = entityHandlerRequest - » requestHandle; 
response.resourceHandle = entityHandlerRequest - > resource; 
response.ehResult = ehRet; 
response. payload = (OCPayload* ) payload; 
response. numSendVendorSpecif icHeaderOptions = 0; 
memset (response. sendVendorSpecif icHeaderOptions, 0, 
sizeof response. sendVendorSpecif icHeaderOpt ions) ; 
memset (response. resourceUri, 0, sizeof response. resourceUri) ; 
// 表 明 响应 不 在 缓存 中 
response.persistentBufferFlag = 0; 
// 发 送 响应 
if (OCDoResponse(&response) == OC STACK OK) 
{ 
OIC LOG(INFO, TAG, "successful send light response"); 
ehRet = OC EH OK; 


) 
if (entityHandlerRequest §& (flag & OC OBSERVE. FLAG)) 
{ 
if (OC OBSERVE REGISTER == entityHandlerRequest — > obsInfo. action) 
t 
OIC LOG (INFO, TAG, ("Received OC OBSERVE REGISTER from client")); 
gLightUnderObservation = 1; 
} 
else if (0C OBSERVE DEREGISTER == entityHandlerRequest — > obsInfo. action) 
í 
OIC LOG (INFO, TAG, ("Received OC OBSERVE DEREGISTER from client") ); 
gLightUnderObservation = 0; 
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OCRepPayloadDestroy(payload); 
return ehRet; 


// 已 注册 Temperature 资源 的 实体 处 理 句柄 

// 当 接收 到 对 资源 的 请 求 时 被 OCStack 调用 

OCEntityHandlerResult OCTemperatureEntityHandlerCb (OCEntityHandlerFlag flag, OCEntityHandlerRequest 
entityHandlerRequest,void * callbackParam) 


t 


OCEntityHandlerResult ehRet - OC EH OK; 
OCEntityHandlerResponse response - (0); 
OCRepPayload * payload = OCRepPayloadCreate(); 
if(! payload) 
{ 
OIC LOG(ERROR, TAG, ("Failed to allocate Payload" )) ; 
return OC_EH_ERROR; 
) 
if(entityHandlerRequest && (flag & OC REQUEST. FLAG) ) 
{ 
OIC LOG (INFO, TAG, ("Flag includes OC REQUEST FLAG")); 
if(OC REST GET == entityHandlerRequest - > method) 
f 
OCRepPayloadSetUri(payload, TEMPERATURE RESOURCE KEY); 
OCRepPayloadSetPropInt(payload, TEMPERATURE RESOURCE KEY, tempval); 
OCRepPayloadSetPropInt(payload, PM25 RESOURCE KEY, pm25val); 
OCRepPayloadSetPropInt(payload, HUM RESOURCE KEY, humval); 
if(pm25val 200) 
digitalWrite(4,HIGH); 
else 
digitalWrite(4,LOW) ; 
) 
if (ehRet == OC EH OK) 
{ 
// 生 成 响应 . 注意 这 需要 一 些 与 请 求 消息 有 关 的 信息 
response.requestHandle = entityHandlerRequest - > requestHandle; 
response.resourceHandle - entityHandlerRequest - » resource; 
response.ehResult = ehRet; 
response.payload = (OCPayload * ) payload; 
response. numSendVendorSpecificHeaderOptions = 0; 
memset (response. sendVendorSpecificHeaderOptions, 0, 
sizeof response. sendVendorSpecif icHeaderOptions) ; 
memset (response. resourceUri, 0, sizeof response. resourceUri) ; 
// 表 明 响 应 不 在 缓存 中 
response.persistentBufferFlag = 0; 
// 发 送 响应 
if (OCDoResponse(&response) == OC STACK OK) 
{ 
OIC LOG(INFO, TAG, "successful send temp response"); 
ehRet - OC EH OK; 


) 
) 
if (entityHandlerRequest && (flag & OC OBSERVE FLAG)) 
{ 
if (OC OBSERVE REGISTER == entityHandlerRequest — > obsInfo. action) 
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OIC LOG (INFO, TAG, ("Received OC OBSERVE REGISTER from client")); 
gLightUnderObservation = 1; 

) 

else if (0C OBSERVE DEREGISTER == entityHandlerRequest - > obsInfo. action) 

{ 
OIC LOG (INFO, TAG, ("Received OC OBSERVE DEREGISTER from client")); 
gLightUnderObservation = 0; 


) 
OCRepPayloadDestroy(payload) ; 
return ehRet; 
} 
// 已 注册 的 LED 资源 的 实体 处 理 句柄 
// 当 接收 到 对 资源 的 请 求 时 被 OCStack 调用 


OCEntityHandlerResult OCLedEntityHandlerCb ( OCEntityHandlerFlag flag, OCEntityHandlerRequest 


entityHandlerRequest,void * callbackParam) 
t 
OCEntityHandlerResult ehRet = OC EH OK; 
OCEntityHandlerResponse response = {0}; 
OCRepPayload * payload = OCRepPayloadCreate(); 
if(! payload) 
{ 
OIC LOG(ERROR, TAG, ("Failed to allocate Payload" )) ; 
return OC_EH_ERROR; 
} 
if(entityHandlerRequest && (flag & OC_REQUEST_FLAG) ) 
{ 
OIC LOG (INFO, TAG, ("Flag includes OC REQUEST FLAG")); 
if(OC REST PUT == entityHandlerRequest - > method) 
{ 
// 执 行 PuT 操作 


OCRepPayload * input = reinterpret_cast <OCRepPayload*>(entityHandlerRequest - > payload) ; 


int64 t Lightstate; 
if(OCRepPayloadGetPropInt(input, LED RESOURCE KEY, &Lightstate)) 
t 
OIC LOG(INFO, TAG, "successful Get led switch"); 
if(Lightstate == 1) 
{ 





digitalWrite(LED_PIN, HIGH) ; 
LED_STATE = 1; 
} 
else 
{ 
digitalWrite(LED_PIN, LOW) ; 
LED_STATE = 0; 
} 
OCRepPayloadSetUri( payload, LED RESOURCE ENDPOINT); 
OCRepPayloadSetPropInt(payload, LED RESOURCE KEY, Lightstate); 
} 
} 
else if(OC_REST_GET == entityHandlerRequest - > method) 
i 
OCRepPayloadSetUri(payload, LED RESOURCE KEY); 


* 
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OCRepPayloadSetPropInt(payload, LED RESOURCE KEY, LED STATE); 
) 
if (ehRet -- OC EH OK) 
{ 
// 生 成 响应 .注意 这 需要 一 些 与 请 求 消息 有 关 的 信息 
response. requestHandle = entityHandlerRequest -> requestHandle; 
response.resourceHandle - entityHandlerRequest - » resource; 
response.ehResult - ehRet; 
response. payload = (OCPayload* ) payload; 
response. numSendVendorSpecificHeaderOptions - 0; 
memset (response. sendVendorSpecificHeaderOptions, 0, sizeof response. sendVendorSpecif icHeaderOptions) ; 
memset (response. resourceUri, 0, sizeof response. resourceUri); 
// 表 明 响应 不 在 持续 的 缓存 中 
response. persistentBufferFlag = 0; 
// 发 送 响应 
if (OCDoResponse(&response) == OC STACK OK) 





OIC LOG(INFO, TAG, "successful send led response"); 
ehRet - OC EH OK; 


} 
if (entityHandlerRequest && (flag & OC_OBSERVE_FLAG) ) 
{ 
if (OC OBSERVE REGISTER == entityHandlerRequest — > obsInfo. action) 
{ 
OIC_LOG (INFO, TAG, ("Received OC_OBSERVE_REGISTER from client")); 
gLightUnderObservation = 1; 
} 
else if (OC OBSERVE DEREGISTER == entityHandlerRequest - > obsInfo.action) 
{ 
OIC LOG (INFO, TAG, ("Received OC OBSERVE DEREGISTER from client")); 
gLightUnderObservation = 0; 


) 
OCRepPayloadDestroy(payload); 
return ehRet; 
} 
// 已 注册 PM2.5 资源 的 实体 处 理 句 柄 
// 当 接收 到 对 资源 的 请 求 时 被 OCStack 调用 
OCEntityHandlerResult OCPm25EntityHandlerCb ( OCEntityHandlerFlag flag, OCEntityHandlerRequest * 
entityHandlerRequest, void * callbackParam) 
{ 
OCEntityHandlerResult ehRet = OC EH OK; 
OCEntityHandlerResponse response - (0); 
OCRepPayload * payload = OCRepPayloadCreate(); 
if(!payload) 
{ 
OIC LOG(ERROR, TAG, ("Failed to allocate Payload")); 
return OC EH ERROR; 
) 
if(entityHandlerRequest && (flag & OC REQUEST FLAG)) 
{ 
OIC LOG (INFO, TAG, ("Flag includes OC REQUEST FLAG")); 
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if(OC REST GET == entityHandlerRequest — method) 
t 
OCRepPayloadSetUri(payload, LIGHT RESOURCE ENDPOINT); 
OCRepPayloadSetPropBool(payload, "state", true); 
OCRepPayloadSetPropInt(payload, "ambientlight", 10); 
) 
else if(OC REST PUT == entityHandlerRequest - > method) 
t 
/ [Af PUT 操作 
OCRepPayloadSetUri(payload, LIGHT RESOURCE ENDPOINT); 
OCRepPayloadSetPropBool(payload, "state", false); 
OCRepPayloadSetPropInt(payload, "power", 10); 
) 
if (ehRet -- OC EH OK) 
{ 
// 生 成 响应 ,注意 这 需要 一 些 与 请 求 消息 有 关 的 信息 
response.requestHandle = entityHandlerRequest - » requestHandle; 
response.resourceHandle - entityHandlerRequest - » resource; 
response.ehResult = ehRet; 
response. payload = (OCPayload* ) payload; 
response. numSendVendorSpecificHeaderOptions = 0; 
memset (response. sendVendorSpecificHeaderOptions, 0, 
sizeof response. sendVendorSpecif icHeaderOptions) ; 
memset(response. resourceUri, 0, sizeof response. resourceUri) ; 
// 表 明 响 应 不 在 缓存 中 
response.persistentBufferFlag = 0; 
// 发 送 响应 
if (OCDoResponse(&response) == OC STACK OK) 
{ 
OIC_LOG(INFO, TAG, "successful send response") ; 
ehRet = OC_EH_OK; 


) 
) 
if (entityHandlerRequest && (flag & OC OBSERVE FLAG)) 
{ 
if (OC OBSERVE REGISTER == entityHandlerRequest 一 > obsInfo. action) 
t 
OIC LOG (INFO, TAG, ("Received OC OBSERVE REGISTER from client")); 
gLightUnderObservation = 1; 
} 
else if (0C OBSERVE DEREGISTER == entityHandlerRequest - > obsInfo. action) 
{ 
OIC LOG (INFO, TAG, ("Received OC OBSERVE DEREGISTER from client") ); 
gLightUnderObservation = 0; 
} 
} 
OCRepPayloadDestroy( payload) ; 
return ehRet; 
} 
//setup 函数 在 启动 程序 时 被 调用 
void setup() 
{ 
// 在 此 处 添加 初始 化 代码 
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// 注 意 : 在 此 将 初始 化 Arduino 的 串口 波 特 率 为 115200 
OIC LOG INIT(); 
OIC LOG(DEBUG, TAG, ("OCServer is starting...")); 
pinMode(LED PIN, OUTPUT) ; 
pinMode(4, OUTPUT) ; 
digitalWrite(LED PIN,LOW); 
digitalWrite(4,LOW); 
LED STATE - 0; 
Serial2.begin(1200); // 串 口 2, 引 脚 16,17 
// 连 接 以 太 网 或 WiFi 网 络 
# if defined(ARDUINOWIFI) || defined(ARDUINOETH) 
if (ConnectToNetwork() != 0) 
{ 
OIC LOG(ERROR, TAG, ("Unable to connect to network")) ; 
return; 
) 
# endif 
// 在 服务 器 端 模式 下 初始 化 OC 协议 栈 
if (OCInit(NULL, 0, OC SERVER) != OC STACK OK) 
{ 
OIC_LOG(ERROR, TAG, ("OCStack init error")); 
return; 
} 
createLightResource( ) ; 
OIC LOG(DEBUG, TAG, ("createLightResource...")); 
createTemperatureResource() ; 
OIC LOG(DEBUG, TAG, ("createTemperatureResource...")); 
createLedResource(); 
OIC LOG(DEBUG, TAG, ("createLedResource...")); 
) 
//Yoop 函数 被 无 休止 地 调用 
void loop() 
i 
// 在 这 里 保持 人 为 的 延迟 ,以 避免 Arduino 微 控制 器 的 连续 旋转 
// 根 据 具体 应 用 需求 进行 修改 
delay(200); 
int data; 
chk = DHT11. read(DHT11PIN) ; 
lightval = analogRead(LIGHT_PIN) ; 
tempval = DHT11. temperature; 
humval = DHT11. humidity; 
Serial. print("the temp is:"); 
Serial. print1n(tempval) ; 
Serial. print("the hum is:"); 
Serial. print1n(humval) ; 
Serial. print("the LED state is:"); 
Serial.println(LED STATE); 
// 向 PM2.5 传感器 发 送 串口 请 求 
Serial2.write(Tx, 5) ; 
inti - 0; 
while(Serial2.available()) 
{ 
Rx[i] = byte(Serial2.read()); 
itt; 
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delay(2); 
} 
Serial. print1n(Rx[4]); 
Serial. print1n(Rx[5]); 
pm25val = Rx[4] * 256 + Rx[5]; 
Serial. print("The PM25 is: "); 
Serial. print1n(pm25val) ; 
Serial.println("#+# ## FH FHF HH RSH B6 s 8 s"); 
// 此 调用 显示 Arduino 上 释放 的 可 用 SRAM 的 数量 
PrintArduinoMemoryStats(); 
// 给 OC 协议 栈 CPU 周期 来 执行 发 送 /接收 ,以 及 其 他 OC 协议 栈 的 东西 
if (OCProcess() != OC_STACK_OK) 
{ 
OIC_LOG(ERROR, TAG, ("OCStack process error")); 
return; 
} 
} 
void createLightResource() 
{ 
OCStackResult res = OCCreateResource(&Light. lighthandle, 
RESOURCE_TYPE, 
ARDUINO_RESOURCE_INTERFACE, 
LIGHT_RESOURCE_ENDPOINT, 
OCLightEnt ityHandlerCb, 
NULL, 
OC DISCOVERABLE|OC OBSERVABLE); 
OIC LOG V(DEBUG, TAG, "Created Light resource with result: * s", getResult(res)); 
) 
void createTemperatureResource( ) 
{ 
OCStackResult res = OCCreateResource(&Temperature. temperaturehandle, 
RESOURCE_TYPE, 
ARDUINO_RESOURCE_INTERFACE, 
TEMPERATURE RESOURCE ENDPOINT, 
OCTenperatureEntityHandlerCb, 
NULL, 
OC DISCOVERABLE|OC OBSERVABLE); 
OIC LOG V(DEBUG, TAG, "Created Temperature resource with result: %s", getResult(res)); 
) 
void createLedResource( ) 
{ 
OCStackResult res = OCCreateResource(&Led. ledhandle, 
RESOURCE_TYPE, 
ARDUINO_RESOURCE_INTERFACE, 
LED RESOURCE ENDPOINT, 
OCLedEntityHandlerCb, 
NULL, 
OC DISCOVERABLE|OC OBSERVABLE); 
OIC LOG V(DEBUG, TAG, "Created Led resource with result: %s", getResult(res)); 
) 
void createPm25Resource( ) 
t 
OCStackResult res = OCCreateResource(&Pm25. pn25handle, 
RESOURCE TYPE, 
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ARDUINO RESOURCE INTERFACE, 
PM25 RESOURCE ENDPOINT, 
OCPn25EntityHandlerCb, 
NULL, 
OC DISCOVERABLE|OC OBSERVABLE); 
OIC LOG V(DEBUG, TAG, "Created Led resource with result: %s", getResult(res)); 
} 
const char * getResult(OCStackResult result) { 
switch (result) { 
case OC_STACK_OK: 
return "OC_STACK_OK"; 
case OC_STACK_INVALID_URI: 
return "OC STACK INVALID URI"; 
case OC STACK INVALID QUERY: 
return "OC STACK INVALID QUERY"; 
case OC STACK INVALID IP: 
return "OC STACK INVALID IP"; 
case OC STACK INVALID PORT: 
return "OC STACK INVALID PORT"; 
case OC STACK INVALID CALLBACK: 
return "OC STACK INVALID CALLBACK"; 
case OC STACK INVALID METHOD: 
return "OC STACK INVALID METHOD"; 
case OC STACK NO MEMORY: 
return "OC STACK NO MEMORY"; 
case OC STACK COMM ERROR: 
return "OC STACK COMM ERROR"; 
case OC STACK INVALID PARAM: 
return "OC STACK INVALID PARAM"; 
case OC STACK NOTIMPL: 
return "OC STACK NOTIMPL"; 
case OC STACK NO RESOURCE: 
return "OC STACK NO RESOURCE"; 
case OC STACK RESOURCE ERROR: 
return "OC STACK RESOURCE ERROR"; 
case OC STACK SLOW RESOURCE: 
return "OC STACK SLOW RESOURCE"; 
case OC STACK NO OBSERVERS: 
return "OC STACK NO OBSERVERS"; 
case OC STACK ERROR: 
return "OC STACK ERROR"; 
default: 
return "UNKNOWN" ; 


12.6.2 Android 实例 


Android 端 应 用 程序 作为 OCF 客户 端 运行 ,实现 手机 实时 监测 Arduino 端 传感器 的 值 .并 实现 开 
关 灯 等 功能 。Android 端 应 用 程序 包括 Constant. java, LEDResource. java, LightResource. java, 
TempResource. java 和 SimpleClient. java 五 部 分 。 
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1, Constant, java 


package org. iotivity. base. examples; 
public class Constants { 

public static String ARDUINO RESOURCE INTERFACE = "core. haier. resources"; 

public static String RESOURCE TYPE = "room. haier"; 

// 资 源 URI 

public static String TEMPERATURE RESOURCE ENDPOINT = "/temperature"; 

public static String LIGHT RESOURCE ENDPOINT = "/ambientlight"; 

public static String LED RESOURCE ENDPOINT - "/led"; 

public static String PM25 RESOURCE ENDPOINT = "/pm2.5"; 

// 属 性 

public static String TEMPERATURE RESOURCE KEY = "temperature"; 

public static String LIGHT RESOURCE KEY = "ambientlight"; 

public static String LED RESOURCE KEY - "switch"; 

public static String PM25 RESOURCE KEY = "pm2.5"; 

public static String HUM RESOURCE KEY - "hun"; 


2. LEDResource. java 


package org. iotivity. base. exanples; 
import org. iotivity. base. OcException; 
import org. iotivity. base. OcRepresentation; 
public class LEDResource { 
public static final String STATE_KEY = Constants. LED_RESOURCE_KEY; 
private int mState; 
public LEDResource( ) ( 
mState = 0; 
) 
public void setOcRepresentation(OcRepresentation rep) throws OcException { 
mState = rep.getValue(LEDResource. STATE KEY); 
) 
public OcRepresentation getOcRepresentation() throws OcException { 
OcRepresentation rep 7 new OcRepresentation(); 
rep.setValue(STATE KEY, mState); 
return rep; 
) 
public int getState() ( 
return mState; 
) 
public void setState(int state) ( 
this.mState - state; 
) 
public String toString() { 
return "Wt" + STATE KEY + ": " + nState; 


) 
3. LightResource, java 


package org. iotivity. base. examples; 
import org. iotivity. base. OcException; 
import org. iotivity. base. OcRepresentation; 
public class LightResource ( 
public static final String LIGHT KEY - Constants.LIGHT RESOURCE, KEY; 
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private int light; 

public LightResource()( 
light - 0; 

} 

public void setOcRepresentation(OcRepresentation rep) throws OcException { 
light = rep. getValue(LightResource. LIGHT_KEY) ; 

} 

public OcRepresentation getOcRepresentation() throws OcException { 
OcRepresentation rep = new OcRepresentation(); 
rep. setValue(LIGHT_KEY, light); 
return rep; 

} 

public int getLight() { 
return light; 

} 

public void setLight(int light) { 
this. light = light; 

} 

public String toString() { 
return "At" + LIGHT KEY + ": " + light; 

} 

} 


4. TempResource, java 


package org. iotivity. base. examples; 

import org. iotivity. base. OcException; 

import org. iotivity. base. OcRepresentation; 

public class TempResource ( 
public static final String TEMP KEY = Constants. TEMPERATURE RESOURCE KEY; 
public static final String HUMI KEY - Constants.HUM RESOURCE KEY; 
public static final String PM25 KEY - Constants.PM25 RESOURCE KEY; 
private int temp; 
private int humi; 
private int pm25; 
public TempResource()( 





temp = 0; 
humi = 0; 
pm25 = 0; 


) 

public void setOcRepresentation(OcRepresentation rep) throws OcException ( 
temp = rep. getValue(TempResource. TEMP KEY); 
humi = rep.getValue(TempResource.HUMI KEY); 
pm25 = rep.getValue(TempResource.PM25 KEY); 


public OcRepresentation getOcRepresentation() throws OcException ( 
OcRepresentation rep = new OcRepresentation(); 
rep.setValue(TEMP KEY, temp); 
rep.setValue(HUMI KEY, humi); 
rep.setValue(PM25 KEY, pm25); 
return rep; 

) 

public int getTemp() { 
return temp; 


) 
public void setTemp(int temp) ( 


this.temp = temp; 

} 

public int getHumi() { 
return humi; 

} 

public void setHumi(int humi) { 
this. humi = humi; 


public int getPm25() { 
return pm25; 

} 

public void setPm25(int pm25) { 
this.pm25 - pm25; 

) 


@override 
public String toString() { 
return "At" + TEMP KEY + ":" + temp + 
"\n\t" + HUMI KEY + ":" + humi + 
"\n\t" + PM25_KEY + ":" + pm25; 


} 
5. SimpleClient, java 


package org. iotivity. base. examples; 
import android. app. Activity; 

import android. content. Context; 
import android. content. Intent; 

import android. nfc. NfcAdapter; 

import android. os. Bundle; 

import android. text. method. ScrollingMovementMethod; 
import android. util. Log; 

import android. widget. Button; 

import android. widget. ScrollView; 
import android. widget. TextView; 
import android. view. LayoutInflater; 
import android. view. View; 

import android. view. ViewGroup; 

import android. widget. BaseAdapter; 
import android. widget. CompoundButton; 
import android. widget. ImageView; 
import android. widget. ListView; 
import android. widget. Switch; 

import android. app. Dialog; 

import android. content. DialogInterface; 
import android. app. AlertDialog; 
import android. os. Handler; 

import android. os. Message; 

import android. widget. Toast; 

import android. widget. RelativeLayout; 
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import android. widget. LinearLayout; 
import org. iotivity. base. ErrorCode; 
import org. iotivity. base. ModeType; 
import org. iotivity. base. ObserveType; 
import org. iotivity. base. OcConnectivityType; 
import org. iotivity. base. OcException; 
import org. iotivity. base. OcHeaderOption; 
import org. iotivity. base. OcPlatform; 
import org. iotivity. base. OcRepresentation; 
import org. iotivity. base. OcResource; 
import org. iotivity. base. OcResourceIdentifier; 
import org. iotivity. base. PlatformConf ig; 
import org. iotivity. base. QualityOfService; 
import org. iotivity. base. ServiceType; 
import java. util. ArrayList; 
import java. util. EnumSet; 
import java. util. HashMap; 
import java. util. List; 
import java. util. Map; 
import java. util. Timer; 
import java. util. TimerTask; 
public class SimpleClient extends Activity implements 
OcPlatform. OnResourceFoundListener, 
OcResource. OnGetListener, 
OcResource. OnPutListener, 
OcResource. OnObserveListener { 
private Map < OcResourceldentifier, OcResource > mFoundResources = new HashMap «»(); 
private OcResource mFoundLightResource = null; 
private OcResource mFoundLedResource = null; 
private OcResource mFoundTempResource = null; 
//1ocal representation of a server's light resource 
private LightResource mLight = new LightResource(); 
private LEDResource mLED = new LEDResource(); 
private TempResource mTemp - new TempResource(); 
/* 该 方法 配置 并 初始 化 平台 ,然后 寻找 资源 类 型 为 "room. haier" 的 资源 * / 
private void startSimpleClient() ( 
Context context = this; 
PlatformConfig platformConfig = new PlatformConfig( 
this, 
context, 
ServiceType.IN PROC, 
ModeType. CLIENT, 
"0.0.0.0", // 通 过 设置 为 "0.0.0.0" 绑 定 到 所 有 可 用 的 接口 
0, // 使 用 随机 可 用 的 端口 
QualityOfService.LOW 
E 
msg(" Configuring platform."); 
OcPlatform. Conf igure(platformConfig); 
try { 
msg("Finding all resources of type \"room. haier\"."); 
String requestUri = OcPlatform. WELL KNOWN QUERY + "?rt=" + Constants. RESOURCE TYPE; 
OcPlatform. findResource("", 
requestUri, 
EnumSet. of (OcConnect ivityType. CT_DEFAULT) , 


第 12 章 “OCF 开 发 方法 及 案例 || 365 


this 
) 
sleep(1); 
) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
nsg("Failed to invoke find resource API"); 
} 
printLine(); 
) 
/ * 当 一 个 "findResource" 请 求 成 功 完成 时 ,执行 该 事件 处 理 器 


* (param ocResource found resource * / 


@Override 
public synchronized void onResourceFound(OcResource ocResource) { 
if (null == ocResource) { 


Message msg - new Message(); 
msg.what - UNCONNECT; 

handler. sendMessage(msg) ; 

msg( "Found resource is invalid"); 
return; 

) 

// 获 取 资源 URI 

String resourceUri = ocResource. getUri(); 

// 获 取 资 源 主机 地 址 

String hostAddress = ocResource. getHost(); 

msg("\tURI of the resource: " + resourceUri); 

msg("\tHost address of the resource: " + hostAddress); 

// 获 取 资 源 类 型 

msg("\tList of resource types: "); 

for (String resourceType : ocResource. getResourceTypes()) ( 
msg("\t\t" + resourceType) ; 

) 

msg("\tList of resource interfaces:"); 

for (String resourceInterface : ocResource. getResourceInterfaces()) { 
msg("\t\t" + resourceInterface); 

} 

msg("\tList of resource connectivity types:"); 

for (OcConnectivityType connect ivityType : ocResource. getConnectivityTypeSet()) { 
msg("\t\t" + connectivityType) ; 

} 

printLine(); 

Message msg = new Message(); 

msg.what - CONNECT; 

handler. sendMessage(msg) ; 

if (resourceUri.equals(Constants.LED RESOURCE ENDPOINT)) { 
mFoundLedResource = ocResource; 
getLedResourceRepresentation(); 

Jelse if(resourceUri.equals(Constants.LIGHT RESOURCE ENDPOINT))( 
mFoundLightResource = ocResource; 
getLightResourceRepresentation(); 

Jelse if(resourceUri.equals(Constants. TEMPERATURE RESOURCE ENDPOINT))( 
mFoundTempResource = ocResource; 
getTenpResourceRepresentation(); 


366 «|| OCF 技 术 原 理 





及 物 联 网 程序 开发 指南 





private void getTempResourceRepresentation(){ 
nsg("Getting Temp Representation..."); 
Map< String, String» queryParams = new HashMap <>(); 
try { 
sleep(1); 
mFoundTempResource. get (queryParams, this); 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
nsg("Error occurred while invoking \"get\" API of Led"); 
} 
} 
private void getLedResourceRepresentat ion( ) ( 
nsg( "Getting Led Representation..."); 
Map < String, String> queryParams = new HashMap <>(); 
try { 
sleep(1); 
mFoundLedResource. get(queryParams, this); 
} catch (OcException e) { 
Log. e(TAG, e.toString()); 
nsg("Error occurred while invoking \"get\" API of Led"); 
) 
} 
/* 本 地 方法 ,获取 一 个 已 发 现 的 Light 资源 的 表示 * / 
private void getLightResourceRepresentation() { 
msg("Getting Light Representation..."); 
Map< String, String> queryParams = new HashMap <>(); 
try { 
sleep(1); 
mFoundLightResource. get(queryParams, this) ; 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
msg("Error occurred while invoking \"get\" API"); 
) 
) 
/ * 当 "get" 请 求 成 功 , 执行 该 事件 处 理 器 * / 
@override 
public synchronized void onGetCompleted(List < OcHeaderOpt.ion > list, OcRepresentation ocRepresentation) { 
msg("GET request was successful") ; 
msg("Resource URI: " + ocRepresentation. getUri()); 
String resourceURI = ocRepresentation. getUri(); 
try { 
if(resourceURI.equals(Constants.LED RESOURCE ENDPOINT))( 
nLED. setOcRepresentation(ocRepresentation); 
nsg("Led attributes: "); 
msg(mLED. toString()); 
printLine(); 
) 
else if(resourceURI.equals(Constants.LIGHT RESOURCE ENDPOINT))( 
// 将 属性 值 读 取 到 Light 的 本 地 表示 中 
mLight. setOcRepresentation(ocRepresentation); 
msg("Light attributes: "); 
nsg(nLight. toString()); 
printLine(); 
Jelse if(resourceURI. equals(Constants. TEMPERATURE RESOURCE ENDPOINT))( 
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mTemp. setOcRepresentat ion(ocRepresentation) ; 
nsg("Light attributes: "); 
msg(mTemp. toString()); 
printLine(); 
} 
Message msg = new Message(); 
msg.what = REFRESH; 
handler. sendMessage(msg) ; 
) catch (OcException e) ( 
Log. e(TAG, e. toString()); 
msg("Failed to read the attributes of a light resource"); 
) 
} 
/ * "get" 请 求 失败 时 应 该 执行 的 操作 * / 
@Override 
public synchronized void onGetFailed(Throwable throwable) { 
if (throwable instanceof OcException) { 
OcException ocEx = (OcException) throwable; 
Log. e(TAG, ocEx. toString()) ; 
ErrorCode errCode = ocEx. getErrorCode( ) ; 
// 根 据 错误 代码 进行 一 些 处 理 
msg("Error code: " + errCode); 
) 
msg("Failed to get representation of a found light resource"); 
) 
private void putLedOnRepersentation()( 
mLED. setState(1); 
msg("Putting led representation..."); 
OcRepresentation representation = null; 
try { 
representation = mLED.getOcRepresentation(); 
) catch (OcException e) { 
Log. e(TAG, e. toString()); 
msg("Failed to get OcRepresentation from a led"); 
} 
Map< String, String> queryParams = new HashMap <>(); 
try { 
sleep(1); 
mFoundLedResource. put (representation, queryParams, this); 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
msg("Error occurred while invoking \"put\" API"); 


} 
private void putLedOffRepersentat ion( ) { 
nLED. setState(0) ; 
msg("Putting led representation. .."); 
OcRepresentation representation = null; 
try { 
representation = mLED.getOcRepresentation(); 
} catch (OcException e) { 
Log. e(TAG, e.toString()); 
msg("Failed to get OcRepresentation froma led"); 
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Map < String, String> queryParams = new HashMap <>(); 
try { 
sleep(1); 
mFoundLedResource. put(representation, queryParams, this) ; 
} catch (OcException e) { 
Log.e(TAG, e. toString()); 
msg("Error occurred while invoking \"put\" API"); 
} 
} 
/ * "put" 操 作成 功 时 进行 的 操作 * / 
@override 
public synchronized void onPutCompleted(List < OcHeaderOption> list, OcRepresentation ocRepresentation) { 
msg("PUT request was successful") ; 
String resourceURI = ocRepresentation. getUri(); 
if (resourceURI.equals(Constants.LED RESOURCE ENDPOINT)) { 
nsg("Led attributes: "); 
msg(mLED. toString()); 
printLine(); 
) 
) 
/ * "put" 请 求 失败 时 进行 的 操作 * / 
@override 
public synchronized void onPutFailed(Throwable throwable) ( 
if (throwable instanceof OcException) ( 
OcException ocEx = (OcException) throwable; 
Log. e(TAG, ocEx. toString()); 
ErrorCode errCode = ocEx.getErrorCode(); 
//do something based on errorCode 
msg("Error code: " + errCode); 
) 
msg( "Failed to \"put\" a new representation"); 
) 
/* 该 方法 开始 观察 Light 资源 * / 
private void observeFoundLightResource() ( 
try { 
sleep(1); 
mFoundLightResource. observe(ObserveType. OBSERVE, new HashMap < String, String>(), this); 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
msg("Error occurred while invoking \"observe\" API"); 


private static int mObserveCount = 0; 
/ * "post" 请 求 成 功 时 进行 的 操作 * / 
@override 
public synchronized void onObserveCompleted(List < OcHeaderOption> list, 
OcRepresentation ocRepresentation, 
int sequenceNumber) { 
if (OcResource. OnObserveListener. REGISTER == sequenceNumber) { 
nsg("Observe registration action is successful:") ; 
} else if (OcResource. OnObserveListener.DEREGISTER == sequenceNumber) { 
nsg("Observe De - registration action is successful"); 
} else if (OcResource.OnObserveListener.NO OPTION == sequenceNumber) ( 
nsg("Observe registration or de - registration action is failed"); 
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) 
nsg( "OBSERVE Result:"); 
msg("\tSequenceNumber:" + sequenceNumber); 
try { 
mLight. setOcRepresentat ion(ocRepresentation) ; 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
msg("Failed to get the attribute values"); 
) 
msg(mLight. toString()); 
if ((++mObserveCount) == 11) { 
msg("Cancelling Observe. .."); 
try { 
mFoundLightResource. cancelObserve() ; 
} catch (OcException e) { 
Log. e(TAG, e. toString()); 
nsg("Error occurred while invoking V'cancelObserveV" API"); 
} 
msg("DONE") ; 
//prepare for the next restart of the SimpleClient 
resetGlobals() ; 
enableStartButton(); 
) 
) 
/ * "observe" 请 求 失败 时 执行 的 操作 * / 
@override 
public synchronized void onObserveFailed(Throwable throwable) { 
if (throwable instanceof OcException) ( 
OcException ocEx = (OcException) throwable; 
Log. e(TAG, ocEx. toString()); 
ErrorCode errCode = ocEx.getErrorCode(); 
msg("Error code: " * errCode); 
) 
msg(" Observation of the found light resource has failed"); 
) 
//oCF 部 分 的 代码 结束 ,开始 设置 
private TextView pm25Value, tempValue, humiValue, lightValue; 
private Switch ledSwitch; 
private AlertDialog.Builder builder; 
private Button refreshButton; 
private static final int CONNECT = 0; 
private static final int REFRESH = 1 
private static final int UNCONNECT = 2; 
private static final int OVERPM25 - 3; 
private static final int BELOWPM25 - 4; 
private boolean isLedOpen = false; 
private static boolean isConnected - false; 
private static boolean isAirContionerOpen = false; 
private final static String TAG - SimpleClient.class.getSimpleName(); 
private TextView mConsoleTextView; 
private ScrollView mScrollView; 
private Handler handler = new Handler() ( 
GOverride 
public void handleMessage(Message msg) ( 
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if (msg. what == CONNECT && ! isConnected) { 
if(builder != null){ 
builder. show(); 
isConnected = true; 
setData(); 
isLedOpen = mLED.getState() = 
ledSwitch. setChecked( isLedOpen) ; 








0 ? false : true; 





} 
} 
if(msg.what == UNCONNECT && isConnected){ 
if(builder != null){ 
builder. setMessage("Can not find resources"); 
builder. show( ) ; 
isConnected = false; 
} 
} 


if(msg.what == OVERPM25 && ! isAirContionerOpen) { 
Toast toast = Toast. makeText(getApplicationContext(), "Haier air conditioner is opening. ", 
Toast. LENGTH_SHORT) ; 
LinearLayout linearLayout = (LinearLayout) toast.getView(); 
TextView nessageTextView = (TextView) linearLayout. getChildAt(0); 
messageTextView. setTextSize(20); 
toast. show() ; 
isAirContionerOpen - true; 
) 
if(msg.what == BELOWPM25 && isAirContionerOpen)( 
Toast toast = Toast. makeText(getApplicationContext(), "Haier air conditioner is closed.", 
Toast. LENGTH SHORT); 
LinearLayout linearLayout = (LinearLayout) toast.getView(); 
TextView messageTextView = (TextView) linearLayout. getChildAt(0); 
messageTextView. setTextSize(20); 
toast. show() ; 
isAirContionerOpen = false; 


) 
if(msg.what == REFRESH)( 
setData(); 
ledSwitch. setChecked( isLedOpen) ; 
) 
) 
i 
@override 


protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState) ; 
setContentView(R.layout.activity simple client); 
builder = new AlertDialog. Builder(this); 
builder. setTitle("Notification"). 
setTitle("Notification"). 
setMessage("Find LED Resource. Vn Find Environment Resource. Vn Find pm25 Resource. Vn Connect 
Success! "). 
setPositiveButton("Confirm", new DialogInterface. OnClickListener() { 
@override 
public void onClick(DialogInterface dialog, int which) { 
} 


}).create(); 
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initGUI(); 
mConsoleTextView = (TextView) findViewById(R. id. consoleTextView); 
mConsoleTextView. setMovementMethod(new ScrollingMovementMethod()); 
mScrollView = (ScrollView) findViewById(R. id. scrollView); 
mScrollView.fullScroll(View.FOCUS DOWN); 
} 
private void initGUI() { 
drawGUI(); 
new Thread(new Runnable() ( 
public void run() ( 
startSimpleClient(); 
} 
)).start(); 
new Thread(new Runnable() ( 
public void run() ( 
while (true) ( 
if (isConnected) ( 
if (mFoundTempResource != null) { 
getTenpResourceRepresentation() ; 
} 
if (mFoundLightResource != null) { 
getLightResourceRepresentation( ) ; 
} 
if (mFoundLedResource != null) { 
getLedResourceRepresentation() ; 
) 
) 
sleep(6); 
) 
I 
}). start(); 
refreshButton. setOnClickListener(new View. OnClickListener() { 
@override 
public void onClick(View v) { 
new Thread(new Runnable() { 
public void run() { 
startSimpleClient() ; 
if (mFoundTempResource != null) { 
getTempResourceRepresentat ion( ) ; 
} 
if (mFoundLightResource != null) { 
getLightResourceRepresentat ion( ) ; 
} 
if (mFoundLedResource != null) { 
getLedResourceRepresentat ion( ) ; 
} 
H 
}). start(); 
} 
n 
ledSwitch. setChecked( isLedOpen) ; 
ledSwitch. setOnCheckedChangeListener(new CompoundButton. OnCheckedChangeListener() { 
@Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
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if(isChecked){ 
isLedOpen = true; 
new Thread(new Runnable() { 
public void run() { 
if(mFoundLedResource != null)( 
putLedOnRepersentation(); 
Jelse{ 
Message msg = new Message(); 
msg. what = UNCONNECT; 
handler. sendMessage(msg) ; 


} 
)).start(); 
}else{ 
isLedOpen = false; 
new Thread(new Runnable() ( 
public void run() ( 
if(mFoundLedResource != null)( 
putLedOffRepersentation(); 
}else{ 
Message msg = new Message(); 
msg. what = UNCONNECT; 
handler. sendMessage(nsg) ; 


} 
}). start(); 


D; 
) 
private void drawGUI()( 
ImageView pm25Image; 
TextView pm25Title; 
RelativeLayout pm25Layout = (RelativeLayout) findViewById(R. id. pm25 layout); 
if (pn25Layout != null) { 
pn25Layout. setBackgroundColor(getResources( ) . getColor(R. color.blue)); 
pm25Image = (ImageView) pm25Layout. findViewById(R. id. image); 
pn25Image. setImageDrawable(getResources(). getDrawable(R. drawable. pm25) ) ; 
pm25Title = (TextView) pm25Layout. findViewById(R. id. title); 
pn25Title. setText("PM25") ; 
pm25Value = (TextView) pm25Layout. findViewById(R. id. value); 
pn25Value. setText("22 ug"); 
} 
ImageView tempImage; 
TextView tempTitle; 
RelativeLayout tempLayout = (RelativeLayout) findViewById(R. id. temp layout); 
if(tempLayout != null)( 
tenpLayout. setBackgroundColor(getResources().getColor(R. color. green) ) ; 
tempImage = (ImageView) tempLayout. findViewById(R. id. image); 
tenpImage. setImageDrawable(getResources(). getDrawable(R. drawable. temp) ) ; 
tempTitle = (TextView) tempLayout. findViewById(R. id. title); 
tempTitle. setText("Temperature"); 
tempValue = (TextView) tempLayout. findViewById(R. id. value); 
tempValue. setText("30 ©"); 
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) 
ImageView humilmage; 
TextView huniTitle; 
RelativeLayout humiLayout = (RelativeLayout) findViewById(R. id. humi layout); 
if(humiLayout != null)( 
humiLayout. setBackgroundColor(getResources(). getColor(R. color. orange) ) ; 
humilmage = (ImageView) humiLayout. findViewById(R. id. image) ; 
huniImage. setImageDrawable(getResources(). getDrawable(R. drawable. humi)); 
humiTitle = (TextView) humiLayout. findViewById(R. id. title); 
humiTitle. setText("Huniditity"); 
humiValue = (TextView) humiLayout. findViewById(R. id. value); 
humiValue. setText("50 %"); 
) 
ImageView lightImage; 
TextView lightTitle; 
RelativeLayout lightLayout = (RelativeLayout) findViewById(R. id. light layout); 
if(lightLayout != null)( 
lightLayout. setBackgroundColor (getResources( ) . getColor(R. color. gray) ); 
lightImage = (ImageView) lightLayout. findViewById(R. id. image) ; 
lightImage. set ImageDrawable(getResources(). getDrawable(R. drawable. ambientlight)); 
lightTitle = (TextView) lightLayout. findViewById(R. id. title); 
lightTitle. setText("Light"); 
lightValue = (TextView) lightLayout. findViewById(R. id. value); 
lightValue. setText("100 Lux"); 
) 
RelativeLayout ledLayout = (RelativeLayout) findViewById(R. id. led layout); 
ledSwitch = (Switch) ledLayout. findViewById(R. id. switch icon); 
refreshButton - (Button) findViewById(R. id. refresh button); 
) 
private void setData() { 
pn25Value.setText(mTemp.getPm25() + " ug"); 
tempValue. setText(mTemp.getTemp() + " C"); 
humiValue. setText(mTemp. getHumi() + " *"); 
lightValue. setText(mLight.getLight() + " Lux"); 
if(mTemp. getPm25() > 200)( 
Message msg = new Message(); 
msg.what = OVERPM25; 
handler. sendMessage(msg) ; 
) 
if(nTemp.getPm25() < 200)( 
Message msg = new Message(); 
msg.what = BELOWPM25; 
handler. sendMessage(nsg) ; 


) 
@override 
protected void onSaveInstanceState( Bundle outState) { 
super. onSaveInstanceState(outState); 
outState. putString("consoleOutputString", mConsoleTextView. getText().toString()); 
} 
@override 
protected void onRestoreInstanceState( Bundle savedInstanceState) { 
super. onRestoreInstanceState(savedInstanceState) ; 
String consoleOutput = savedInstanceState. getString("consoleOutputString"); 
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nConsoleTextView. setText (consoleOutput) ; 
) 
private void enableStartButton() { 
runOnUiThread(new Runnable() ( 
public void run() ( 
) 
n; 
) 
private void sleep(int seconds) ( 
try { 
Thread. sleep(seconds * 500); 
} catch (InterruptedException e) { 
e. printStackTrace( ) ; 
Log. e(TAG, e. toString()); 


} 
private void msg(final String text) { 
runOnUiThread(new Runnable() { 
public void run() { 
mConsoleTextView. append("\n") ; 
mConsoleTextView. append( text) ; 
mScrollView.fullScroll(View.FOCUS DOWN); 
) 
n; 
Log. i(TAG, text); 
) 
private void printLine() ( 
NE ee a Se E "); 


private synchronized void resetGlobals() { 
mFoundLightResource - null; 
mFoundResources. clear() ; 
mLight = new LightResource(); 
mLED = new LEDResource() ; 
mTemp = new TempResource(); 
mObserveCount - 0; 
) 
GOverride 
public void onNewIntent(Intent intent) ( 
super. onNewIntent( intent) ; 
Log. d(TAG, "onNewIntent with changes sending broadcast IN"); 
Intent i = new Intent(); 
i. setAction( intent. getAction()) ; 
i.putExtra(NfcAdapter.EXTRA NDEF MESSAGES, 
intent. getParcelableArrayExtra(NfcAdapter. EXTRA NDEF MESSAGES)); 
sendBroadcast(i); 
Log.d(TAG, "Initialize Context again resetting"); 


